Sessions de téléversement
Les sessions de téléversement sont l'élément central d'Apertur. Elles définissent comment, quand et où les photos sont collectées auprès des utilisateurs finaux via des QR codes.
Qu'est-ce qu'une session?
Une session est un lien à usage unique et à durée limitée qui permet à un utilisateur final de téléverser une ou plusieurs photos depuis son appareil mobile. Chaque session possède son propre QR code, sa configuration et sa destination de livraison.
Lorsque vous créez une session via l'API, Apertur génère une URL unique et un QR code. L'utilisateur final scanne le code, prend ou sélectionne des photos, et les images sont livrées à votre destination configurée (webhook, S3, Google Drive, etc.).
Les sessions expirent automatiquement après une durée configurable, garantissant que les liens de téléversement ne restent pas actifs indéfiniment.
Options de configuration
Lors de la création d'une session, vous pouvez personnaliser son comportement avec les paramètres suivants :
| Paramètre | Type | Description |
|---|---|---|
| expires_in | integer | Durée en secondes avant l'expiration de la session. Par défaut : 3600 (1 heure). Maximum : 604800 (7 jours). |
| max_images | integer | Nombre maximum d'images que l'utilisateur peut téléverser. Par défaut : 10. Maximum : 50. |
| allowed_mime_types | string[] | Restreindre les types de fichiers acceptés. P. ex. ["image/jpeg", "image/png"]. Par défaut, tous les types d'image sont acceptés. |
| password | string | Exiger un mot de passe avant que l'utilisateur puisse téléverser. Le mot de passe est haché côté serveur. |
| delivery_mode | string | Destination de livraison des photos : webhook, s3, gdrive, dropbox, onedrive, ftp, azure_blob ou webdav. |
| tags | object | Métadonnées clé-valeur arbitraires attachées à la session et incluses dans les données envoyées par webhook. |
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" }
}'Meilleures pratiques pour les QR codes
Le QR code est le moyen par lequel les utilisateurs finaux accèdent à la page de téléversement. Suivez ces recommandations pour une expérience optimale.
Taille et résolution
Générez des QR codes d'au moins 200x200 pixels pour l'affichage à l'écran, ou 300 DPI pour l'impression. Les codes plus grands sont scannés plus facilement à distance.
Positionnement et contraste
Placez les QR codes sur un fond clair avec un contraste élevé. Évitez de les placer sur des images chargées ou près d'autres éléments visuels. Laissez une zone de silence (bordure blanche) d'au moins 4 modules autour du code.
Conseils d'impression
- Utilisez des finis mats pour éviter les reflets qui nuisent à la numérisation.
- Testez les codes imprimés dans les mêmes conditions d'éclairage que l'environnement final.
- Ajoutez une courte instruction comme « Scannez pour téléverser des photos » près du code.
- Envisagez d'ajouter votre logo au centre du QR code (avec un niveau de correction d'erreur H).
Affichage numérique
Lorsque vous affichez des QR codes sur des écrans (tablettes, bornes, moniteurs), assurez-vous que la luminosité de l'écran est suffisante et qu'il n'y a pas de reflet causé par un protecteur d'écran. Pour les très grands écrans, augmentez la taille du QR code proportionnellement.
Cycle de vie d'une session
Une session passe par plusieurs états au cours de sa durée de vie :
La session a été créée, mais aucune photo n'a encore été téléversée.
Au moins une photo a été téléversée. La session accepte encore d'autres photos.
Toutes les photos ont été téléversées (max_images atteint) ou la session a été complétée manuellement. La livraison est en cours ou terminée.
La session a dépassé son heure d'expiration. Aucun téléversement supplémentaire n'est accepté.
Vous pouvez interroger le statut actuel d'une session à tout moment en utilisant GET /api/v1/sessions/:id. Des notifications par webhook et événements sont également envoyées à chaque changement de statut.
Surveillance en temps réel
Apertur offre plusieurs moyens de surveiller vos sessions en temps réel.
Tableau de bord
Le tableau de bord de votre projet affiche toutes les sessions actives avec leur statut actuel, le nombre de téléversements et le temps restant. Les sessions se mettent à jour en temps réel — pas besoin de rafraîchir.
Interrogation longue
Pour les intégrations côté serveur, vous pouvez utiliser l'interrogation longue (long polling) pour attendre les mises à jour de session sans interroger l'API à répétition.
curl https://api.apertur.ca/v1/sessions/sess_01HX.../poll \ -H "Authorization: Bearer aptr_xxxx" \ -H "Accept: application/json"
Consultez la documentation sur l'interrogation longue pour les détails d'implémentation.
Articles connexes
Cet article vous a-t-il été utile?
Besoin d'aide supplémentaire? Contacter le soutien