Versions et changelog

Politique de version

• Chemin versionné : /public/v1. Une rupture de compatibilité donnerait une nouvelle version de chemin ; la v1 resterait servie pendant la transition.
• Date de version : en-tête Tauraco-Version (aujourd'hui 2026-11-01), facultatif en requête, toujours renvoyé.
• Ajouts compatibles sans préavis : nouveau champ dans une réponse, nouvel événement, nouveau filtre facultatif, nouveau code d'erreur. Votre code doit ignorer les champs inconnus.
• Retraits : annoncés par Deprecation, Sunset et Link: <…>; rel="deprecation" sur l'opération concernée, et dans ce changelog.
• Version de l'API : 1.0.0-beta tant que la bêta n'est pas close.

État des surfaces

Statuts au 2026-11-06, au sens du rapport de livraison : « développé et testé » (code et tests verts), « déployé et accessible » (adresse en production vérifiée le 2026-11-05, ou le 2026-11-06 pour les noms sous tauraco.ai), « développé mais non déployé », « partiellement implémenté », « bloqué par une dépendance », « non commencé ». La mise en production a eu lieu le 2026-11-05.

Changelog

2026-11-06 : noms dédiés sous tauraco.ai

• https://mcp.tauraco.ai/mcp est en ligne : même serveur MCP que https://api.tauraco.io/mcp, même réponse 401 avec resource_metadata sans jeton ; l'identité de la ressource reste https://api.tauraco.io/mcp.
• https://developers.tauraco.ai redirige vers ce portail.
• https://api.tauraco.ai redirige (308, chemin, méthode et corps conservés) vers https://api.tauraco.io, qui reste l'adresse canonique de l'API et l'émetteur des jetons.

2026-11-05 : mise en production

• L'API publique, l'API banque, le serveur d'autorisation OAuth (enregistrement dynamique compris), le serveur MCP, les exports, les webhooks v2 et les connecteurs sont ouverts en production. Adresses canoniques sous https://api.tauraco.io ; voir Surfaces et adresses.
• Alias en ligne : https://mcp.tauraco.io/mcp (même ressource que https://api.tauraco.io/mcp) et https://developers.tauraco.io (redirige vers ce portail). Les noms api.tauraco.ai, mcp.tauraco.ai et developers.tauraco.ai ont suivi le 2026-11-06.
• Avertissements juridiques de l'API banque validés.
• La sandbox reste à venir.

2026-11-05 — sandbox construite, scénarios de test, alignements

• Sandbox construite (pile isolée, données fictives, récepteur de webhooks de démonstration) mais pas encore lancée : voir Environnements sandbox.
• Seize scénarios de test de bout en bout (exports, isolation entre entreprises, scopes, banque, révocation, MCP, connecteurs, documents privés, injection de formules, conformité de l'OpenAPI, migrations).
• Odoo : envoi des partenaires et des factures en brouillon seulement ; pas de tirage en v1.
• MCP : tauraco_get_financing_status répond le même refus not_found pour une demande absente et pour la demande d'une autre entreprise.
• Résumés en français des opérations de l'établissement financier (/bank/*) dans le fichier OpenAPI ; aucun chemin ni schéma modifié.

2026-11-04 — spécification OpenAPI et collection Postman

• Fichier OpenAPI 3.1 de l'API publique (73 opérations, version 1.0.0-beta) exporté de l'application, et collection Postman générée depuis ce fichier, téléchargeables depuis la Référence API REST. Les opérations de l'établissement financier (/bank/*) y figurent (API banque, lot 2C).

2026-11-03 — portail développeurs (bêta)

• Première publication du portail développeurs, en français et en anglais : seize pages, exemples cURL, Python, TypeScript, Java et C#.
• Référence interactive servie localement (Scalar 1.76.4, sans script ni police tiers) .
• Documentation des 31 scopes, des 24 codes d'erreur, des 13 événements de webhooks, des 24 jeux de données et des 8 formats d'export.

2026-11-01 — version 1.0.0-beta de l'API (en développement)

• Périmètre : environ 40 opérations REST, OAuth client_credentials et authorization_code avec PKCE, webhooks v2 signés, serveur MCP en lecture seule, API banque en lecture avec compléments et réconciliation.

Hors version 1