Premiers pas

Rendez-vous sur la page d'inscription et créez votre compte Apertur gratuit.

1. Entrez votre adresse courriel et choisissez un mot de passe sécurisé.
2. Vérifiez votre adresse courriel en cliquant sur le lien que nous vous envoyons.
3. Complétez votre profil avec votre nom et votre entreprise (facultatif).
4. C'est fait! Vous accéderez à votre tableau de bord.

Les projets vous permettent d'organiser vos sessions de téléversement, clés API et destinations sous un même toit. Vous pouvez créer des projets distincts pour différentes applications ou environnements.

1. Depuis votre tableau de bord, cliquez sur Nouveau projet.
2. Donnez un nom descriptif à votre projet (p. ex. « Application de réclamations d'assurance »).
3. Ajoutez facultativement une description pour aider votre équipe à l'identifier plus tard.
4. Cliquez sur Créer le projet pour terminer.

Vous pouvez créer autant de projets que votre forfait le permet. Chaque projet dispose de son propre ensemble de clés API et de quotas d'utilisation.

Les clés API authentifient vos requêtes côté serveur vers l'API Apertur. Chaque clé est associée à un seul projet.

1. Ouvrez votre projet et naviguez vers Paramètres > Clés API.
2. Sélectionnez l'environnement : <codeTest/> pour le développement ou <codeLive/> pour la production.
3. Donnez un libellé à la clé pour pouvoir l'identifier plus tard.
4. Cliquez sur Générer la clé. Votre clé sera affichée une seule fois — copiez-la maintenant.

Les clés suivent le format <code/> — le préfixe indique l'environnement. Consultez la documentation d'authentification pour plus de détails.

Une session de téléversement génère un QR code unique que les utilisateurs finaux scannent pour téléverser des photos directement depuis leur appareil mobile.

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"
}

Le <code/> dans la réponse est le lien que vos utilisateurs finaux ouvriront. Vous pouvez l'intégrer dans un QR code, l'envoyer par SMS ou l'afficher directement dans votre application.

Vérifions maintenant que tout fonctionne de bout en bout.

1. Générez un QR code à partir de la valeur <codeQrUrl/> (utilisez n'importe quelle bibliothèque QR, ou le paquet npm <codeQrcode/>).
2. Scannez le QR code avec l'appareil photo de votre téléphone.
3. Vous serez redirigé vers la page de téléversement d'Apertur — appuyez pour prendre ou sélectionner une photo.
4. Téléversez la photo. Le statut de la session passera à active.
5. Une fois toutes les photos téléversées (ou la session expirée), le statut passe à completed et votre webhook reçoit les données.