Sesiones de carga
Las sesiones de carga son el componente fundamental de Apertur. Definen como, cuando y donde se recopilan las fotos de los usuarios finales mediante QR codes.
Que es una sesion?
Una sesion es un enlace de un solo uso con tiempo limitado que permite a un usuario final subir una o mas fotos desde su dispositivo movil. Cada sesion tiene su propio QR code, configuracion y destino de entrega.
Cuando crea una sesion a traves de la API, Apertur genera una URL y un QR code unicos. El usuario final escanea el codigo, toma o selecciona fotos, y las imagenes se entregan al destino configurado (webhook, S3, Google Drive, etc.).
Las sesiones expiran automaticamente despues de una duracion configurable, lo que garantiza que los enlaces de carga no permanezcan activos indefinidamente.
Opciones de configuracion
Al crear una sesion, puede personalizar su comportamiento con los siguientes parametros:
| Parametro | Tipo | Descripcion |
|---|---|---|
| expires_in | integer | Tiempo en segundos hasta que la sesion expire. Predeterminado: 3600 (1 hora). Maximo: 604800 (7 dias). |
| max_images | integer | Numero maximo de imagenes que el usuario puede subir. Predeterminado: 10. Maximo: 50. |
| allowed_mime_types | string[] | Restringe los tipos de archivo aceptados. Ej.: ["image/jpeg", "image/png"]. Por defecto, se aceptan todos los tipos de imagen. |
| password | string | Requiere una contrasena antes de que el usuario pueda subir fotos. La contrasena se hashea en el servidor. |
| delivery_mode | string | Donde entregar las fotos: webhook, s3, gdrive, dropbox, onedrive, ftp, azure_blob o webdav. |
| tags | object | Metadatos arbitrarios de clave-valor asociados a la sesion e incluidos en los payloads de webhooks. |
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",
"expires_in": 7200,
"max_images": 3,
"allowed_mime_types": ["image/jpeg", "image/png"],
"password": "secret123",
"tags": { "claim_id": "CLM-4521" }
}'Mejores practicas para QR codes
El QR code es la forma en que los usuarios finales acceden a la pagina de carga. Siga estas pautas para obtener la mejor experiencia.
Tamano y resolucion
Genere QR codes con un minimo de 200x200 pixeles para visualizacion en pantalla, o 300 DPI para impresion. Los codigos mas grandes se escanean de forma mas confiable a distancia.
Ubicacion y contraste
Coloque los QR codes sobre un fondo claro con alto contraste. Evite colocarlos sobre imagenes complejas o cerca de ruido visual. Deje una zona de silencio (borde blanco) de al menos 4 modulos alrededor del codigo.
Consejos de impresion
- Use acabados mate para evitar reflejos que interfieran con el escaneo.
- Pruebe los codigos impresos bajo las mismas condiciones de iluminacion que el entorno final.
- Incluya una instruccion breve como "Escanee para subir fotos" cerca del codigo.
- Considere agregar su logotipo en el centro del QR code (con nivel de correccion de errores H).
Visualizacion digital
Al mostrar QR codes en pantallas (tabletas, quioscos, monitores), asegurese de que el brillo de la pantalla sea suficiente y que no haya reflejos del protector de pantalla. Para pantallas muy grandes, aumente el tamano del QR code proporcionalmente.
Ciclo de vida de la sesion
Una sesion pasa por varios estados durante su ciclo de vida:
La sesion ha sido creada pero aun no se han subido fotos.
Se ha subido al menos una foto. La sesion aun acepta mas fotos.
Todas las fotos han sido subidas (se alcanzo el limite de max_images) o la sesion fue completada manualmente. La entrega esta en progreso o finalizada.
La sesion ha superado su tiempo de expiracion. No se aceptan mas cargas.
Puede consultar el estado actual de una sesion en cualquier momento usando GET /api/v1/sessions/:id. Tambien se envian notificaciones por webhook y eventos con cada cambio de estado.
Monitoreo en tiempo real
Apertur ofrece varias formas de monitorear sus sesiones en tiempo real.
Panel de control
El panel de control de su proyecto muestra todas las sesiones activas con su estado actual, conteo de cargas y tiempo restante. Las sesiones se actualizan en tiempo real, sin necesidad de recargar la pagina.
Long Polling
Para integraciones del lado del servidor, puede usar long polling para esperar actualizaciones de sesion sin consultar la API repetidamente.
curl https://api.apertur.ca/v1/sessions/sess_01HX.../poll \ -H "Authorization: Bearer aptr_xxxx" \ -H "Accept: application/json"
Consulte la documentacion de long polling para detalles de implementacion.
Articulos relacionados
Le resulto util este articulo?
Necesita mas ayuda? Contactar soporte