Portail développeurs Tauraco

Tauraco ouvre ses données d'entreprise aux logiciels de ses clients, aux établissements financiers et aux assistants IA, avec les mêmes contrôles que l'application : chaque appel ne voit que l'entreprise qui l'a autorisé, et seulement les données que ses scopes couvrent. Ce portail décrit l'API publique, l'authentification OAuth 2.0, les webhooks signés, les exports, les connecteurs ERP, l'API banque et le serveur MCP.

En ligne depuis le 2026-11-05, en version bêta (1.0.0-beta). L'API publique, l'API banque, le serveur d'autorisation OAuth, le serveur MCP et ce portail sont déployés en production et répondent aux adresses ci-dessous (vérifié le 2026-11-05). Depuis le 2026-11-06, les noms dédiés sous tauraco.ai répondent aussi. La sandbox reste à venir. La page Versions et changelog suit l'état de chaque surface.

Surfaces et adresses

Les adresses canoniques sont sous api.tauraco.io ; l'émetteur des jetons et l'identité de la ressource MCP restent https://api.tauraco.io, quel que soit l'alias employé. Les alias mcp.tauraco.io et developers.tauraco.io sont en ligne depuis le 2026-11-05, les noms dédiés mcp.tauraco.ai, developers.tauraco.ai et api.tauraco.ai depuis le 2026-11-06. api.tauraco.ai n'est qu'une redirection 308 vers api.tauraco.io (chemin, méthode et corps conservés) : pour vos appels, visez directement https://api.tauraco.io, car de nombreux clients HTTP retirent l'en-tête Authorization quand ils suivent une redirection vers un autre hôte.

Par où commencer

• Démarrage rapide : une application, un jeton, un premier appel, en dix minutes.
• Authentification : OAuth 2.0, scopes, révocation.
• Référence API REST : conventions, fichier OpenAPI, collection Postman.
• Guide des webhooks : événements, signature Standard Webhooks, rejeu.
• Guide des exports : 24 jeux de données, 8 formats, exports planifiés.
• Guide d'intégration ERP : connecteurs, mapping comptable, synchronisation.
• Guide d'intégration bancaire : dossiers transmis, pièces, échéances, réconciliation.
• Documentation Tauraco Collateral : sûretés et dépôts en lecture.
• Documentation MCP : connecter Claude ou un autre client MCP.
• Exemples de code : cURL, Python, TypeScript, Java, C#.
• Gestion des erreurs : un code stable par erreur.
• Environnements sandbox, Versions et changelog, FAQ, Support développeurs.

Principes communs

• Une application, un octroi par entreprise. Une application n'accède à une entreprise que si un administrateur de cette entreprise l'a autorisée. L'entreprise vient toujours de l'octroi, jamais d'un paramètre ou d'un en-tête.
• Scopes fermés. Trente et un scopes documentés ; chaque opération exige le sien, en plus des contrôles de rôle de l'application Tauraco.
• Révocation immédiate. L'octroi est relu à chaque appel : une révocation coupe l'accès à la requête suivante, sans attendre l'expiration du jeton.
• Montants exacts. Les montants sont des chaînes décimales en unités majeures ("1180000" en XOF, "1234.56" en EUR), jamais des nombres à virgule flottante. Les dates sont en ISO 8601 UTC avec Z.
• Erreurs normalisées. RFC 9457 (application/problem+json) avec un code stable et un request_id.
• Minimisation. Les données personnelles, les coordonnées bancaires et les champs internes sont exclus par défaut ; aucun montant ni taux dans les événements de financement.
• Aucune décision par API. Offre, déclin, versement, radiation ou mainlevée restent des gestes humains dans le portail Tauraco.

Ce qui n'est pas dans la version 1

Écritures de stock et de comptabilité par API, ressources /projects, /contracts et /guarantees, événements invoice.updated, tender.published et guarantee.status_changed, écritures MCP autres que la demande d'export, mTLS, DPoP et FAPI. La liste et les raisons figurent dans Versions et changelog.