FAQ

L'API est-elle disponible aujourd'hui ?

Oui, en version bêta, depuis le 2026-11-05 : l'API publique, l'API banque, le serveur d'autorisation OAuth et le serveur MCP sont en ligne sous https://api.tauraco.io. Sans jeton, ils répondent 401 : c'est normal. La sandbox, elle, n'est pas encore lancée. Suivez Versions et changelog.

Pourquoi api.tauraco.io et pas api.tauraco.ai ?

api.tauraco.io est l'hôte canonique : il porte l'OpenAPI, l'émetteur des jetons (https://api.tauraco.io) et l'identité de la ressource MCP (https://api.tauraco.io/mcp). Les alias mcp.tauraco.io et developers.tauraco.io sont en ligne depuis le 2026-11-05, les noms mcp.tauraco.ai, developers.tauraco.ai et api.tauraco.ai depuis le 2026-11-06. api.tauraco.ai redirige (308) vers api.tauraco.io et l'émetteur reste https://api.tauraco.io : appelez directement api.tauraco.io, car de nombreux clients HTTP retirent l'en-tête Authorization en suivant une redirection vers un autre hôte.

Comment obtenir des identifiants ?

Un administrateur de l'entreprise (ERP_OWNER ou ERP_ADMIN) crée l'application dans Données et intégrations › Applications connectées, ou autorise votre application par son identifiant public. Pour un établissement financier, c'est un décideur de l'établissement. Tauraco ne délivre aucun identifiant par e-mail.

J'ai perdu le secret de mon application.

Il n'est affiché qu'une fois et Tauraco n'en garde qu'une empreinte. Faites tourner le secret depuis la console : un nouveau secret est affiché, l'ancien cesse de fonctionner immédiatement.

Une même application peut-elle servir plusieurs entreprises ?

Oui : chaque entreprise l'autorise séparément, et chaque jeton ne concerne qu'une entreprise. Passez tenant à /oauth/token pour choisir l'entreprise quand plusieurs l'ont autorisée.

Pourquoi un 404 sur une ressource qui existe ?

Une ressource d'une autre entreprise, une ressource que vos droits ne permettent pas de voir et une ressource absente donnent la même réponse, pour ne rien révéler. Vérifiez l'entreprise de l'octroi et vos scopes.

Pourquoi les montants sont-ils des chaînes ?

Pour rester exacts : un nombre à virgule flottante perd des centimes. Lisez-les avec un type décimal (Decimal, BigDecimal, decimal). Le nombre de décimales suit la devise : aucune en XOF, XAF, GNF et KMF.

Puis-je recevoir deux fois le même webhook ?

Oui, la livraison est « au moins une fois ». Dédoublonnez sur webhook-id, stable sur les reprises et les rejeux.

Un assistant IA peut-il modifier mes données ?

Non. Le serveur MCP est en lecture seule ; sa seule écriture crée un export, sans rien modifier. Il agit avec les droits de l'utilisateur qui l'a connecté, dans l'entreprise choisie, et l'accès se révoque à tout moment depuis IA et MCP.

Une banque peut-elle accepter ou refuser un financement par l'API ?

Non. L'API banque lit les dossiers, demande des compléments et rapproche des remboursements ; les décisions restent des gestes humains dans le portail.

Les connecteurs Sage, QuickBooks ou SAP sont-ils disponibles ?

Sage, QuickBooks, EBP et Pennylane sont prévus en mode fichier (« configuration requise ») ; SAP, Dynamics 365, Oracle, NetSuite, Cegid, Xero, Sage X3 et les API Sage (Accounting, Intacct, Active) ne sont pas pris en charge. Voir le guide d'intégration ERP.

Où signaler une faille de sécurité ?

À [email protected], sans divulgation publique avant correction. Voir Support développeurs.