Primeros pasos

Visite la pagina de registro y cree su cuenta gratuita de Apertur.

1. Ingrese su direccion de correo electronico y elija una contrasena segura.
2. Verifique su direccion de correo electronico haciendo clic en el enlace que le enviaremos.
3. Complete su perfil con su nombre y empresa (opcional).
4. Listo! Accedera a su panel de control.

Los proyectos le permiten organizar sesiones de carga, API keys y destinos en un solo lugar. Puede crear proyectos separados para diferentes aplicaciones o entornos.

1. Desde su panel de control, haga clic en Nuevo proyecto.
2. Asigne un nombre descriptivo a su proyecto (por ejemplo, "App de Reclamos de Seguros").
3. Opcionalmente agregue una descripcion para ayudar a su equipo a identificarlo despues.
4. Haga clic en Crear proyecto para finalizar.

Puede crear tantos proyectos como su plan lo permita. Cada proyecto tiene su propio conjunto de API keys y cuotas de uso.

Las API keys autentican sus solicitudes del lado del servidor a la API de Apertur. Cada clave esta asociada a un solo proyecto.

1. Abra su proyecto y navegue a Configuracion > API Keys.
2. Seleccione el entorno: <codeTest/> para desarrollo o <codeLive/> para produccion.
3. Asigne una etiqueta a la clave para poder identificarla despues.
4. Haga clic en Generar clave. Su clave se mostrara una sola vez: copiela ahora.

Las claves siguen el formato <code/> — el prefijo indica el entorno. Consulte la documentacion de autenticacion para mas detalles.

Una sesion de carga genera un QR code unico que los usuarios finales escanean para subir fotos directamente desde su dispositivo movil.

curl -X POST https://api.apertur.ca/v1/sessions \
  -H "Authorization: Bearer aptr_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "delivery_mode": "webhook",
    "webhook_url": "https://your-app.com/webhook",
    "max_images": 5,
    "tags": { "user_id": "usr_123" }
  }'

{
  "id": "sess_01HX...",
  "qr_url": "https://apertur.ca/u/sess_01HX...",
  "status": "pending",
  "max_images": 5,
  "expires_at": "2026-04-03T14:00:00Z"
}

El <code/> en la respuesta es el enlace que abriran sus usuarios finales. Puede incrustarlo en un QR code, enviarlo por SMS o mostrarlo directamente en su aplicacion.

Ahora verifiquemos que todo funcione de principio a fin.

1. Genere un QR code a partir del valor <codeQrUrl/> (use cualquier biblioteca de QR codes o el paquete <codeQrcode/> de npm).
2. Escanee el QR code con la camara de su telefono.
3. Sera dirigido a la pagina de carga de Apertur: toque para tomar o seleccionar una foto.
4. Suba la foto. El estado de la sesion cambiara a active.
5. Una vez que todas las fotos se hayan subido (o la sesion expire), el estado cambia a completed y su webhook recibe el payload.