Destinations

Webhook

Les webhooks sont la méthode de livraison la plus courante. Apertur envoie une requête HTTP POST à votre URL avec les données de la photo dès que chaque image est téléversée.

1. Définissez delivery_mode à "webhook" lors de la création d'une session.
2. Fournissez l'URL de votre point de terminaison dans le paramètre webhook_url.
3. Choisissez optionnellement un format : json_base64 (par défaut) ou multipart.
4. Votre point de terminaison doit répondre avec un code de statut 2xx dans les 30 secondes.
5. En cas d'échec de livraison, Apertur réessaie avec un délai exponentiel jusqu'à 5 fois.

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/api/photos",
    "webhook_format": "json_base64"
  }'

Pour une configuration avancée incluant les en-têtes personnalisés et la vérification des signatures, consultez la documentation des webhooks.

Amazon S3

Livrez les photos directement dans un compartiment Amazon S3. Idéal pour les flux de travail qui traitent les images depuis S3 à l'aide de Lambda ou d'autres services infonuagiques.

1. Naviguez vers Paramètres du projet > Destinations et ajoutez une nouvelle destination S3.
2. Entrez le nom du compartiment, la région et les identifiants (identifiant de clé d'accès et secret).
3. Configurez optionnellement un modèle de clé pour des chemins de fichiers personnalisés.
4. Testez la connexion pour vérifier qu'Apertur peut écrire dans votre compartiment.
5. Lors de la création de sessions, définissez delivery_mode à s3 et référencez cette destination.
6. Cliquez sur Enregistrer pour terminer.

// Example destination config (via API)
{
  "type": "s3",
  "bucket": "my-photos-bucket",
  "region": "us-east-1",
  "access_key_id": "AKIA...",
  "secret_access_key": "wJal...",
  "key_template": "uploads/{session_id}/{image_index}.{ext}"
}

Google Drive

Livrez les photos dans un dossier Google Drive. Idéal pour les équipes qui utilisent déjà Google Workspace pour la collaboration.

1. Allez dans Paramètres du projet > Destinations et ajoutez une destination Google Drive.
2. Cliquez sur Connecter un compte Google pour autoriser Apertur via OAuth.
3. Sélectionnez le dossier cible (ou laissez Apertur en créer un).
4. Configurez optionnellement un modèle de sous-dossier à l'aide de variables de session.
5. Cliquez sur Enregistrer. Les photos seront livrées dans le dossier sélectionné.

Apertur ne demande que les portées minimales nécessaires pour écrire des fichiers dans votre Drive. Vous pouvez révoquer l'accès à tout moment depuis les paramètres de votre compte Google.

Dropbox

Livrez les photos dans un dossier Dropbox. Utile pour les flux de travail qui reposent sur Dropbox pour le partage et le stockage de fichiers.

1. Naviguez vers Paramètres du projet > Destinations et ajoutez une destination Dropbox.
2. Cliquez sur Connecter Dropbox pour autoriser via OAuth.
3. Choisissez le chemin du dossier cible.
4. Configurez optionnellement un modèle de sous-dossier.
5. Cliquez sur Enregistrer pour terminer la configuration.

help.destinations.dropboxNote

OneDrive

Livrez les photos dans un dossier OneDrive. Fonctionne avec les comptes personnels et OneDrive Entreprise.

1. Allez dans Paramètres du projet > Destinations et ajoutez une destination OneDrive.
2. Cliquez sur Connecter un compte Microsoft pour autoriser via OAuth.
3. Sélectionnez le dossier cible ou entrez un chemin personnalisé.
4. Configurez optionnellement un modèle de sous-dossier.
5. Cliquez sur Enregistrer pour compléter la configuration.

OneDrive Entreprise peut nécessiter le consentement d'un administrateur dans votre locataire Microsoft 365 avant la connexion.

FTP / SFTP

Livrez les photos vers un serveur FTP ou SFTP. Couramment utilisé dans les environnements d'entreprise et les intégrations héritées.

1. Naviguez vers Paramètres du projet > Destinations et ajoutez une destination FTP/SFTP.
2. help.destinations.ftpStep2
3. Spécifiez le chemin du répertoire distant où les photos doivent être téléversées.
4. Testez la connexion pour vous assurer qu'Apertur peut s'authentifier et écrire des fichiers.
5. Cliquez sur Enregistrer pour terminer.

Azure Blob Storage

Livrez les photos dans un conteneur Azure Blob Storage. Fonctionne bien avec Azure Functions, Logic Apps et d'autres services Azure.

1. Allez dans Paramètres du projet > Destinations et ajoutez une destination Azure Blob.
2. Entrez le nom du compte de stockage, le nom du conteneur et le jeton SAS (ou la chaîne de connexion).
3. Configurez optionnellement un modèle de chemin d'objet blob.
4. Testez la connexion pour vérifier l'accès en écriture.
5. Cliquez sur Enregistrer pour terminer.

// Example destination config (via API)
{
  "type": "azure_blob",
  "account_name": "mystorageaccount",
  "container_name": "photos",
  "sas_token": "sv=2023-01-03&st=...",
  "blob_template": "uploads/{session_id}/{image_index}.{ext}"
}

WebDAV

Livrez les photos vers n'importe quel serveur compatible WebDAV. Prend en charge Nextcloud, ownCloud et d'autres implémentations WebDAV.

1. Naviguez vers Paramètres du projet > Destinations et ajoutez une destination WebDAV.
2. help.destinations.webdavStep2
3. Spécifiez le chemin du répertoire distant.
4. Testez la connexion pour vous assurer qu'Apertur peut écrire des fichiers.
5. Cliquez sur Enregistrer pour terminer.

Assurez-vous que votre serveur WebDAV prend en charge la méthode PUT et que le répertoire cible existe.

Tester votre destination

Avant d'utiliser une destination en production, nous recommandons de la tester avec une session d'essai.

1. Créez une session en utilisant une clé API de test.
2. Définissez max_images à 1 pour un test rapide.
3. Scannez le QR code et téléversez une photo de test.
4. Vérifiez que la photo est arrivée à votre destination.