Solucion de problemas

413 — Archivo demasiado grande

El archivo subido excede el tamano maximo permitido (predeterminado: 20 MB por imagen). Reduzca el tamano del archivo o configure un limite mas alto si su plan lo admite.

415 — Tipo de medio no admitido

El tipo de archivo no es aceptado. Verifique el parametro allowed_mime_types en su sesion. Por defecto, solo se permiten tipos de imagen (JPEG, PNG, WebP, HEIC).

422 — Sesion llena

La sesion ya alcanzo su limite de max_images. Cree una nueva sesion si necesita mas cargas.

500 — Error del servidor

Ocurrio un error inesperado de nuestro lado. Esto es poco frecuente y generalmente se resuelve en minutos. Consulte la pagina de estado de Apertur para incidentes en curso.

No recibe webhooks

Si su endpoint no esta recibiendo entregas de webhooks, verifique lo siguiente:

• Verifique que la URL de su webhook sea accesible publicamente (no este detras de un firewall o VPN).
• Asegurese de que su endpoint responda con un codigo de estado 2xx dentro de los 30 segundos.
• Revise los registros de entrega en el panel de control de su proyecto para ver los detalles del error.
• Confirme que el delivery_mode de la sesion este establecido en "webhook".

Fallo en la verificacion de firmas

Si la verificacion de firmas falla de su lado:

• Asegurese de usar el cuerpo de la solicitud en bruto (no una version analizada o re-serializada).
• Verifique que este usando el secreto de webhook correcto para este proyecto.
• Asegurese de comparar la cadena de firma completa incluyendo el prefijo "sha256=".

Consulte la guia de firmas de webhooks para ejemplos de implementacion.

Entregas duplicadas

En casos poco frecuentes, Apertur puede reintentar una entrega si la respuesta inicial fue ambigua (por ejemplo, un timeout). Use el encabezado X-APTR-Delivery-ID para deduplicar de su lado.

La camara no se abre

• Asegurese de que el usuario haya otorgado permisos de camara a su navegador.
• La pagina de carga debe servirse mediante HTTPS (esto siempre es asi con las URLs alojadas en Apertur).
• Intente usar un navegador diferente (Safari en iOS, Chrome en Android).
• Borre la cache del navegador e intente de nuevo.
• En iOS, asegurese de que la camara no este restringida por Tiempo en Pantalla o politicas MDM.

El QR code muestra un error

• "Session expired" — la sesion ha superado su tiempo de expires_at. Cree una nueva sesion.
• "Session full" — se ha alcanzado el limite de max_images.
• "Session not found" — el ID de sesion en la URL no es valido. Verifique que el QR code se haya generado correctamente.

Compartir QR codes entre dispositivos

Cada QR code enlaza a una URL de sesion unica. Puede compartir esta URL por SMS, correo electronico o aplicaciones de mensajeria en lugar de escanear: simplemente envie el valor de qr_url directamente.

Como manejar la expiracion

• Aumente el parametro expires_in al crear sesiones si los usuarios necesitan mas tiempo.
• Monitoree el estado de las sesiones y cree nuevas sesiones de forma proactiva cuando sea necesario.
• Informe a sus usuarios finales sobre el limite de tiempo para que suban sus fotos a tiempo.

Correo electronico

Envienos un correo electronico a support@apertur.ca. Normalmente respondemos dentro de un dia habil.

Formulario de contacto

Use nuestro formulario de contacto para enviar una solicitud de soporte detallada. Incluya su ID de proyecto, ID de sesion y cualquier mensaje de error para ayudarnos a resolver su problema mas rapidamente.

Pagina de estado

Consulte la pagina de estado de Apertur para obtener informacion en tiempo real sobre la disponibilidad de la plataforma e incidentes en curso.