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 parcourir votre Drive ni d'interroger l'API en boucle : les données viennent à vous, signées pour que vous puissiez leur faire confiance.
Incluse dans tous les forfaits, Free compris
GET /public-api/documents?limit=.POST signé à chaque document classé.Construisez une requête, signez un webhook et testez une URL. Tout ce qui suit s'exécute dans votre navigateur : aucune clé n'est nécessaire et rien n'est envoyé nulle part.
curl -H "Authorization: Bearer fk_live_YOUR_KEY" \ "https://rlarmblikgtxmqlertzg.supabase.co/functions/v1/public-api/documents?limit=50"
X-Findest-Signature
b3b9e23591666c957e333722d8399c653471e6aa1f69fa6a05792495c83b0a11
Créez une clé d'API sur la page API de l'application, puis appelez l'endpoint pour obtenir les mêmes enregistrements que dans votre Historique : nom du fichier, type détecté, statut et destination finale.
| Paramètre | Description |
|---|---|
| Authorization | En-tête. Bearer <votre clé>. Une clé ne renvoie que les documents de son propre compte. |
| limit | Query, facultatif. Nombre de documents à renvoyer, les plus récents d'abord. 50 par défaut, 200 au maximum. |
{
"documents": [
{
"id": "a1b2c3d4",
"filename": "Facture_Endesa_2026-03-14.pdf",
"doc_type": "Facture",
"status": "uploaded",
"destination": { "folder_name": "Factures 2026" },
"created_at": "2026-03-14T09:12:03Z"
}
]
}
Définissez une URL de webhook une fois pour toutes : à chaque document classé, Findest lui envoie un POST signé. Plus besoin d'interroger l'API à intervalle régulier.
// En-tête : X-Findest-Signature: <HMAC-SHA256 en hex du corps brut> { "event": "document.archived", "data": { "id": "a1b2c3d4", "filename": "Facture_Endesa_2026-03-14.pdf", "doc_type": "Facture", "folder_name": "Factures 2026", "web_link": "https://drive.google.com/file/d/…" }, "sent_at": "2026-03-14T09:12:04Z" }
import crypto from "node:crypto"; function isFromFindest(rawBody, signature, secret) { const expected = crypto .createHmac("sha256", secret) .update(rawBody) .digest("hex"); return signature?.length === expected.length && crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected)); }
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 différence, ignorez la requête. Le secret n'est affiché qu'une seule fois, à la création du webhook.
Si votre endpoint est indisponible ou trop lent, le classement réussit quand même. Le webhook n'est pas encore relancé : voyez-y une notification et faites de l'API la source de vérité.
L'URL doit être en https:// sur le port 443 et pointer vers un hôte public. Les redirections ne sont pas suivies et chaque appel expire au bout de 10 secondes.
Dans l'application, sur la page API de la barre latérale. La clé en clair n'est affichée qu'une seule fois, à sa création : Findest ne conserve que son empreinte, copiez-la donc avant de fermer la fenêtre.
GET /public-api/documents renvoie au maximum 200 enregistrements par requête (50 par défaut, réglable avec ?limit=). Il n'y a pas encore de limite stricte par minute, mais voyez-y un endpoint de lecture pour vos propres intégrations, pas une API publique pour des tiers.
Pas encore. Aujourd'hui l'API publique est en lecture seule (documents), plus le webhook sortant. Les règles, les connexions et les équipes se gèrent depuis l'application.
Non, la livraison se fait en un seul essai pour le moment. Utilisez l'API pour rattraper ce que vous auriez manqué plutôt que de vous reposer uniquement sur le webhook.
Recalculez le HMAC-SHA256 du corps brut de la requête avec votre secret de webhook et comparez-le à l'en-tête X-Findest-Signature. Le secret n'est affiché qu'une seule fois, à la création du webhook.