Tôt ou tard, chaque équipe veut que ses documents dialoguent avec le reste de ses logiciels : déposer un fichier depuis un script, lancer un workflow depuis un planificateur ou être prévenue dès qu'un document est traité. AuraDoc propose deux voies complémentaires. L'API REST permet à vos systèmes de demander quelque chose à AuraDoc, et les webhooks permettent à AuraDoc de signaler à vos systèmes que quelque chose s'est produit. Cet article parcourt les deux, ainsi que les détails de sécurité qui comptent en production.
Clés d'API et portées
Tout commence par une clé d'API. Créez-en une dans Dashboard › Settings › API keys, nommez-la et choisissez ses portées. Les portées limitent ce que la clé peut faire : une clé servant uniquement à déposer des fichiers n'a pas besoin du droit d'administrer autre chose. Une clé ne peut pas en créer une autre aux portées plus larges, et les autorisations effectives sont toujours celles que partagent la clé et le rôle de la personne, comme décrit dans rôles et autorisations d'équipe. Les requêtes portent la clé dans l'en-tête Authorization sous forme de jeton bearer.
La même page affiche des statistiques d'utilisation par clé, pour voir quelle intégration est active et laquelle s'est tue. Sur les offres payantes, vous pouvez aussi fixer une limite de débit pour une clé précise, utile pour qu'un script bruyant ne pénalise pas les autres. Si une clé fuite, supprimez-la et créez-en une autre ; rien d'autre ne change côté AuraDoc.
Ce que l'API permet
La page des intégrations de la documentation indique l'adresse de base et fournit des exemples prêts à copier. Vous pouvez aujourd'hui déposer un document, demander à AuraDoc d'ingérer un document depuis une URL, lancer l'exécution d'un workflow et créer une demande de signature, chacun par une seule requête authentifiée. Ce sont les mêmes opérations que celles des personnes dans le tableau de bord ; le résultat créé par l'API apparaît dans l'interface comme les autres.
Si vous préférez interroger plutôt que recevoir des appels, des points d'accès de type déclencheur renvoient les nouveaux documents, les exécutions de workflow terminées et les signatures terminées, avec un catalogue qui les décrit. Les outils qui ne reçoivent pas de webhooks, comme les compléments de tableur ou les plateformes sans code, peuvent les consulter à intervalles réguliers. La référence complète se trouve sur la page de documentation des intégrations.
Webhooks sortants
Pour des notifications en temps réel, ouvrez Dashboard › Webhooks et ajoutez un point de terminaison. Vous choisissez les événements voulus dans une liste : document créé, classé et supprimé, OCR et traduction terminés ou en échec, événements de workflow, alertes de quota de stockage et événements de signature. À l'enregistrement, AuraDoc affiche le secret de signature une seule fois. Copiez-le aussitôt dans votre service récepteur ; en cas de perte, renouvelez le secret : un nouveau est généré et la rotation est consignée dans la piste d'audit.
Vous pouvez façonner le contenu avec un modèle, de quelques milliers de caractères au plus, et le valider avant l'enregistrement. Un bouton de test envoie un événement d'exemple, marqué par un en-tête de test, pour vérifier que votre point de terminaison répond et lit le corps avant d'en dépendre. Chaque webhook peut être désactivé sans être supprimé, ce qui aide pendant les fenêtres de maintenance.
Vérifier les signatures et gérer les échecs
Chaque envoi est signé. AuraDoc calcule un HMAC-SHA256 sur l'horodatage et le corps brut avec votre secret et place le résultat dans l'en-tête de signature, avec des en-têtes pour le nom de l'événement, l'identifiant du webhook, l'identifiant de l'envoi, l'horodatage et le nombre de relances. Votre récepteur doit recalculer la signature depuis le corps brut, la comparer en temps constant et rejeter les requêtes à l'horodatage trop ancien. Ainsi, personne ne peut forger un événement vers votre point de terminaison, même en connaissant son adresse.
Les points de terminaison tombent en panne, et AuraDoc l'anticipe. Quand un envoi échoue, il est relancé automatiquement avec des délais croissants, de cinq minutes à six heures. La vue des envois montre chaque tentative et son résultat, et vous pouvez relancer à la main une fois le problème corrigé. Comme le même identifiant d'envoi sert pour les relances, votre récepteur peut ignorer les doublons sans risque. Pour associer webhooks et fichiers arrivant de fournisseurs, voir stockage cloud et dossiers surveillés.