Vos archives,
reliées à vos propres outils.
Un endpoint REST pour lire ce que Findest a déjà classé, et un webhook sortant qui se déclenche à l'instant où un document arrive dans votre cloud. Pas besoin de scanner votre Drive, ni d'interroger l'API en boucle — les données viennent à vous, signées pour que vous puissiez leur faire confiance.
Un endpoint, tout votre historique.
Générez une clé d'API depuis Paramètres → Intégrations dans
l'application, puis appelez
GET /public-api/documents pour récupérer les mêmes
informations que dans votre Historique : nom du fichier, type
détecté, statut et destination finale.
- Authentification Bearer : une clé par compte, affichée une seule fois à sa création
- Révocable à tout moment : depuis le même écran de Paramètres, sans ticket support
- Isolée par compte : une clé ne renvoie que les documents de ce compte
curl \ -H "Authorization: Bearer fk_live_..." \ https://rlarmblikgtxmqlertzg.supabase.co/functions/v1/public-api/documents?limit=50 → 200 OK { "documents": [ { "id": "a1b2c3d4", "filename": "Facture_AcmePower_2026-03-14.pdf", "doc_type": "invoice", "status": "uploaded", "destination": { "folder_name": "factures_2026" }, "created_at": "2026-03-14T09:12:03Z" } ] }
Soyez prévenu à l'instant.
Configurez une URL de webhook une fois pour toutes, et
chaque fois qu'un document est classé avec succès, Findest lui
envoie un POST signé — plus besoin d'interroger l'API
régulièrement.
X-Findest-Signature: 7e5a... (HMAC-SHA256 du corps, avec votre secret de webhook) { "event": "document.archived", "data": { …même format qu'un document ci-dessus… }, "sent_at": "2026-03-14T09:12:04Z" }
Vérifiez que c'est bien nous
Recalculez le HMAC-SHA256 du corps brut de la requête avec votre
secret de webhook et comparez-le à
X-Findest-Signature. En cas de non-correspondance,
ignorez la requête.
Livraison au mieux, sans relance
Si votre serveur est indisponible ou trop lent à répondre, le classement en lui-même réussit quand même — Findest ne relance pas encore le webhook, traitez-le donc comme une notification, pas comme source de vérité (c'est le rôle de l'API).
Les questions les plus fréquentes.
Où puis-je obtenir une clé d'API ?
Dans l'application, sous Paramètres → Intégrations. La clé en clair n'est affichée qu'une seule fois, à sa création — Findest ne conserve que son empreinte, notez-la donc avant de fermer la fenêtre.
Y a-t-il une limite de requêtes ?
GET /public-api/documents plafonne
chaque requête à 200 enregistrements. Il n'y a pas encore de
limite stricte par minute, mais traitez-le comme un endpoint de
lecture pour vos propres intégrations, pas comme une API publique
pour des tiers.
Puis-je créer des documents ou des règles via l'API ?
Pas encore — aujourd'hui l'API publique est en lecture seule (documents) plus le webhook sortant. La gestion des règles, des connexions et des équipes se fait depuis l'application.
Le webhook relance-t-il si mon serveur est indisponible ?
Non, la livraison se fait en un seul essai pour le moment. Utilisez l'API pour rattraper ce que vous auriez pu manquer, plutôt que de compter uniquement sur le webhook.
Générez votre première clé d'API.
C'est dans Paramètres → Intégrations, sur tous les forfaits, prêt en une minute.