Make (Integromat) : scénarios MaxScanner
Utilisez les modules HTTP et Webhooks de Make pour convertir et compresser des fichiers avec MaxScanner, ou leur appliquer l’OCR, dans n’importe quel scénario.
Réponse courte
Dans Make, ajoutez le module HTTP « Make a request » avec la méthode POST, l’URL https://maxscanner.app/api/v1/jobs/, un en-tête Authorization: Bearer <key>, le type de corps Raw et le type de contenu JSON. Stockez la clé dans une connexion ou un data store Make, et non dans des champs de module en clair partagés avec d’autres personnes. Pour être averti de la fin du traitement, créez un scénario Webhooks « Custom webhook » et abonnez son URL à processing.completed.
Démarrage rapide
- 1Créez une clé API MaxScanner nommée « Make ».
- 2Ajoutez HTTP → Make a request : POST https://maxscanner.app/api/v1/jobs/, en-têtes Authorization et Idempotency-Key, corps JSON avec url, filename, format. Activez « Parse response ».
- 3Créez un scénario distinct qui commence par Webhooks → Custom webhook et copiez l’adresse du webhook.
- 4Abonnez cette adresse une seule fois avec POST /api/v1/hooks/subscribe/ (événement processing.completed).
- 5Dans le scénario du webhook, ajoutez HTTP → Make a request : GET {{data.statusUrl}} avec l’en-tête Authorization, puis transmettez output.downloadUrl au module suivant.
Corps de la requête
Associez Idempotency-Key à une valeur unique par élément, comme l’ID d’enregistrement du bundle, pour que la réexécution d’un scénario en échec ne crée pas de tâches en double.
{
"url": "{{1.attachment.url}}",
"filename": "{{1.attachment.name}}",
"format": "pdf"
}Interrogation au sein d’un seul scénario
Si un webhook n’est pas envisageable, ajoutez un module Sleep (5 à 10 secondes) et un Repeater avec un routeur qui s’arrête quand status vaut completed ou failed. Ce schéma consomme plus d’opérations et de requêtes MaxScanner que le webhook : réservez-le aux faibles volumes.
Gestion des erreurs
Associez un gestionnaire d’erreurs au module HTTP : Break avec nouvelles tentatives automatiques pour les réponses 429 et 5xx, et Ignore ou Rollback pour les réponses 4xx qui nécessitent une correction. Make affiche le code d’erreur MaxScanner dans la sortie du module.
Questions fréquentes
Puis-je envoyer le fichier en binaire plutôt qu’une URL ?
Oui : appelez /extension/upload/ pour obtenir une URL signée, envoyez le binaire avec PUT dans un second module HTTP, puis utilisez la valeur objectKey renvoyée comme sourceKey.