Guides
Chaque décision de conception de l'API a sa propre page ici, pas seulement une ligne dans la Référence — modèle de tâche asynchrone, webhooks, idempotence, pagination, gestion des erreurs, limites de débit, bbox (option payante), et comment les paramètres du compte interagissent avec les appels API.
Modèle de tâche asynchrone
Comment le traitement asynchrone des documents et des lots fonctionne dans l'API v1 — la machine à états queued/processing/succeeded/failed/canceled et la chaîne de timestamps created_at/started_at/completed_at.
Webhooks
Enregistrez une URL de rappel pour être notifié lorsqu'un batch se termine, sans avoir à interroger l'API — vérification de signature Standard Webhooks, structure de l'événement, comportement de réessai, événement d'achèvement bbox, et comment le retraitement d'un batch déclenche automatiquement une nouvelle notification.
Idempotence
Utilisez l'en-tête Idempotency-Key pour réessayer en toute sécurité les téléversements de documents, le traitement par lots et les déclenchements bbox sans payer ni exécuter deux fois la même opération.
Pagination
Les points de terminaison de liste de l'API v1 utilisent une pagination opaque par curseur — pas de numéros de page — via un next_page_token que vous renvoyez textuellement, sans jamais le décoder ni le construire vous-même.
Gestion des erreurs
Chaque erreur v1 est un objet JSON contenant type, code, message et doc_url — cette page documente la taxonomie complète des types d'erreur et chaque code d'erreur individuel, et correspond exactement à la page vers laquelle un doc_url renvoyé redirige.
Limites de débit
Les limites de débit v1 s'appliquent par compte, pas par adresse IP, et chaque réponse inclut les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset pour vous permettre de vous auto-limiter avant d'atteindre un HTTP 429.
Zones de délimitation (bbox)
bbox est une seconde passe optionnelle et facturée séparément qui localise exactement sur la page d'où provient chaque valeur extraite — coordonnées directes du modèle sans vérification au niveau du pixel, donc considérez la précision comme approximative, pas exacte.
Paramètres du compte et comportement de l'API
La v1 lit directement les paramètres de votre compte depuis l'application web (annotation automatique bbox, politique de conservation, qualité) plutôt que d'exposer une couche de configuration API distincte — cette page explique exactement quels paramètres l'API suit toujours et le seul que vous pouvez remplacer par requête.