Dépannage

413 — Fichier trop volumineux

Le fichier téléversé dépasse la taille maximale autorisée (par défaut : 20 Mo par image). Réduisez la taille du fichier ou configurez une limite plus élevée si votre forfait le permet.

415 — Type de média non pris en charge

Le type de fichier n'est pas accepté. Vérifiez le paramètre allowed_mime_types de votre session. Par défaut, seuls les types d'image (JPEG, PNG, WebP, HEIC) sont autorisés.

422 — Session complète

La session a déjà atteint sa limite max_images. Créez une nouvelle session si d'autres téléversements sont nécessaires.

500 — Erreur du serveur

Une erreur inattendue est survenue de notre côté. Cela est rare et se résout généralement en quelques minutes. Consultez la page de statut d'Apertur pour les incidents en cours.

Webhooks non reçus

Si votre point de terminaison ne reçoit pas les livraisons de webhook, vérifiez les éléments suivants :

• Vérifiez que votre URL de webhook est accessible publiquement (pas derrière un pare-feu ou un VPN).
• Assurez-vous que votre point de terminaison répond avec un code de statut 2xx dans les 30 secondes.
• Consultez les journaux de livraison dans le tableau de bord de votre projet pour les détails des erreurs.
• Confirmez que le delivery_mode de la session est défini à "webhook".

Échec de la vérification de signature

Si la vérification de signature échoue de votre côté :

• Assurez-vous d'utiliser le corps brut de la requête (et non une version analysée ou resérialisée).
• Vérifiez que vous utilisez le bon secret de webhook pour ce projet.
• Assurez-vous de comparer la chaîne de signature complète, y compris le préfixe « sha256= ».

Consultez le guide des signatures de webhook pour des exemples d'implémentation.

Livraisons en double

Dans de rares cas, Apertur peut réessayer une livraison si la réponse initiale était ambiguë (p. ex. un délai d'expiration). Utilisez l'en-tête X-APTR-Delivery-ID pour dédupliquer de votre côté.

La caméra ne s'ouvre pas

• Assurez-vous que l'utilisateur a accordé les permissions de caméra à son navigateur.
• La page de téléversement doit être servie en HTTPS (c'est toujours le cas avec les URL hébergées par Apertur).
• Essayez d'utiliser un autre navigateur (Safari sur iOS, Chrome sur Android).
• Videz le cache du navigateur et réessayez.
• Sur iOS, assurez-vous que la caméra n'est pas restreinte par Temps d'écran ou des politiques MDM.

Le QR code affiche une erreur

• « Session expirée » — la session a dépassé son heure expires_at. Créez une nouvelle session.
• « Session complète » — la limite max_images a été atteinte.
• « Session introuvable » — l'identifiant de session dans l'URL est invalide. Vérifiez que le QR code a été généré correctement.

Partager des QR codes entre appareils

Chaque QR code mène à une URL de session unique. Vous pouvez partager cette URL par SMS, courriel ou applications de messagerie au lieu de scanner — envoyez simplement la valeur qr_url directement.

Comment gérer l'expiration

• Augmentez le paramètre expires_in lors de la création de sessions si les utilisateurs ont besoin de plus de temps.
• Surveillez le statut des sessions et créez proactivement de nouvelles sessions au besoin.
• Informez vos utilisateurs finaux de la limite de temps afin qu'ils téléversent rapidement.

Courriel

Envoyez-nous un courriel à support@apertur.ca. Nous répondons généralement dans un délai d'un jour ouvrable.

Formulaire de contact

Utilisez notre formulaire de contact pour soumettre une demande de soutien détaillée. Incluez votre identifiant de projet, l'identifiant de session et tout message d'erreur pour nous aider à résoudre votre problème plus rapidement.

Page de statut

Consultez la page de statut d'Apertur pour des informations en temps réel sur la disponibilité de la plateforme et les incidents en cours.