Aller au contenu principal

Trouvez votre prochain outil

Tableau de bordApplication Android
Langue
Apparence
API développeurs et automatisation

Automatisez vos documents avec MAXScanner

Une API REST pour convertir, fusionner et passer des documents à l’OCR, avec une prise en charge complète de Zapier, Make et n8n. Démarrez gratuitement, sans carte bancaire.

Démarrage rapide

  1. Connectez-vous et ouvrez votre Tableau de bord, puis API et automatisation → Clés d’API → Créer une clé.
  2. Copiez la clé (affichée une seule fois) ; elle ressemble à mxs_xxxxxxxx_xxxxxxxxxxxx.
  3. Envoyez-la comme jeton Bearer à chaque requête : Authorization: Bearer YOUR_API_KEY.
curl -X POST https://maxscanner.app/api/v1/convert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/report.docx","filename":"report.docx","format":"pdf"}' \
  --output report.pdf
EN DIRECT

Essayez l’API dès maintenant

Ceci appelle le véritable endpoint /api/v1/sandbox/convert et convertit un petit document de démonstration généré à la volée. Aucune clé d’API n’est nécessaire, et cela ne fonctionne que depuis cette page sur maxscanner.app : impossible de l’intégrer ou de l’exploiter ailleurs.

Limites d’utilisation et crédits gratuits

FORFAIT GRATUIT

10 / jour

et 100 requêtes par mois, gratuit pour toujours. Sans carte bancaire.

FORFAITS PAYANTS

2 000 – illimité

Starter (2 000 crédits/mois), Pro (10 000/mois), Business (illimité).

Les forfaits payants consomment des crédits par opération :

Convertir — 2 créditsFusionner — 1 créditOCR — 3 créditsVérification de la consommation — gratuit

Endpoints

URL de base : https://maxscanner.app/api/v1

GET/healthgratuit, sans clé

Vérifie que l’API est disponible ; utile pour l’étape « Tester la connexion » de Zapier.

RÉPONSE

{ "status": "ok", "service": "MAXScanner Public API", "version": "v1" }
GET/usagegratuit

Consultez votre forfait actuel et le quota restant pour la clé envoyée.

RÉPONSE

{ "plan": "Free", "limits": { "per_day": 10, "per_month": 100 },
  "remaining": { "today": 7, "this_month": 84 } }
POST/convert2 crédits

Convertit un document accessible par URL vers un autre format (pdf, docx, xlsx, pptx, txt, html, png, ...).

CORPS DE LA REQUÊTE

{ "url": "https://example.com/report.docx",
  "filename": "report.docx", "format": "pdf" }

RÉPONSE

Fichier binaire (le Content-Type correspond au format demandé)
POST/merge1 crédit

Fusionne de 2 à 20 PDF (fournis sous forme d’URL) en un seul PDF, dans l’ordre indiqué.

CORPS DE LA REQUÊTE

{ "files": ["https://.../page1.pdf", "https://.../page2.pdf"] }

RÉPONSE

Fichier binaire (application/pdf)
POST/ocr3 crédits

Extrait le texte d’une image ou d’un PDF numérisé grâce à un véritable OCR, même sans couche de texte.

CORPS DE LA REQUÊTE

{ "url": "https://.../scan.pdf", "filename": "scan.pdf", "language": "eng" }

RÉPONSE

{ "text": "...", "pages": 3, "language": "eng" }
POST/documents/import1 crédit

Envoie un fichier DANS votre bibliothèque MAXScanner depuis une automatisation : le sens inverse de /convert.

CORPS DE LA REQUÊTE

{ "url": "https://.../invoice.pdf", "filename": "invoice.pdf" }

RÉPONSE

{ "id": "...", "filename": "invoice.pdf", "downloadUrl": "..." }
POST/hooks/subscribegratuit

Enregistre une URL de webhook pour recevoir les futurs événements d’un type donné. Voir « Webhooks, Zapier et n8n » ci-dessous.

CORPS DE LA REQUÊTE

{ "event": "scan.created", "targetUrl": "https://hooks.zapier.com/..." }

RÉPONSE

{ "id": "...", "event": "scan.created", "targetUrl": "..." }
POST/hooks/unsubscribegratuit

Supprime un abonnement webhook à partir de son id.

CORPS DE LA REQUÊTE

{ "id": "..." }

RÉPONSE

{ "success": true }
GET/hooksgratuit

Liste vos abonnements webhook actifs, avec l’état de la dernière livraison de chacun.

RÉPONSE

{ "subscriptions": [{ "id": "...", "event": "scan.created", "targetUrl": "..." }] }

/convert PREND EN CHARGE (PAS SEULEMENT LES FORMATS OFFICE)

Word / Excel / PowerPointPDFle classique « Office vers PDF »
PDFWord / texte brut / HTML« PDF vers Office »
PDFImage PNG / JPGune image par page
Image PNG / JPGPDFtransforme une image en page PDF

Zapier, Make, n8n et webhooks

Connectez l’application Android MAXScanner à plus de 5 000 applications. Dans l’application, ouvrez Paramètres → Zapier et automatisation (ou la tuile API et automatisation dans Outils) pour vous abonner et obtenir votre clé d’intégration, puis utilisez-la comme clé d’API MAXScanner à l’étape de connexion de Zapier. La même clé fonctionne aussi pour les appels REST directs ci-dessus.

DÉCLENCHEURS DISPONIBLES

Nouveau document numériséscan.createdTous les forfaits

Se déclenche à chaque nouveau document numérisé dans l’application.

Nouvel export PDFpdf.exportedTous les forfaits

Se déclenche lorsqu’un groupe de documents est exporté en PDF.

Nouvelle numérisation géolocaliséegeotag.capturedPro et supérieurs

Se déclenche pour les numérisations comportant des données de localisation (adresse, ville, coordonnées).

Nouvelle capture horodatéetimestamp.capturedBusiness

Se déclenche pour les captures horodatées.

Nouveau texte OCR extraitocr.completedPro et supérieurs

Se déclenche lorsque le texte OCR de l’appareil est disponible pour une numérisation.

Nouveau QR code scannéqr.scannedTous les forfaits

Se déclenche dès qu’un QR code est scanné dans l’application, avec le texte décodé.

Make.com

Scénarios d’automatisation visuels

n8n

Automatisation de flux auto-hébergée

Webhooks

Callbacks HTTP directs pour tout le reste

Les trois plateformes fonctionnent de la même façon : elles vous fournissent une URL, et vous demandez à MAXScanner d’y envoyer un POST via /hooks/subscribe. Pas encore d’application Zapier native à installer : on utilise l’action générique Webhooks by Zapier de Zapier, qui fonctionne dès aujourd’hui.

⚡ Zapier étape par étape

  1. Créez un Zap → recherchez l’application Webhooks by Zapier → choisissez l’événement déclencheur Catch Hook.
  2. Zapier vous fournit une URL de webhook personnalisée (par ex. https://hooks.zapier.com/hooks/catch/...). Copiez-la.
  3. Appelez une fois /hooks/subscribe de MAXScanner avec cette URL et l’événement souhaité (voir l’exemple curl ci-dessous).
  4. De retour dans Zapier, déclenchez un événement de test depuis l’application (par ex. numérisez un document) : l’étape Catch Hook doit afficher des données d’exemple. Continuez ensuite l’action de votre Zap (Google Drive, Sheets, Slack, e-mail, etc.).

🔄 n8n étape par étape

  1. Ajoutez un nœud déclencheur Webhook à un nouveau flux. Configurez-le pour accepter les requêtes POST.
  2. Copiez la Production URL du nœud (activez d’abord le flux pour qu’il soit en ligne).
  3. Appelez /hooks/subscribe avec cette URL et l’événement choisi.
  4. Déclenchez un événement de test depuis l’application : le nœud Webhook reçoit la charge utile, prête à être reliée au reste de votre flux.

S’abonner avec curl

curl -X POST https://maxscanner.app/api/v1/hooks/subscribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event":"scan.created","targetUrl":"https://hooks.zapier.com/hooks/catch/.../..."}'

Prêt à automatiser vos documents ?

Créez une clé d’API gratuite : 10 requêtes par jour, 100 par mois, sans carte bancaire.