À quoi ressemble une API bien faite
Des adresses lisibles, des réponses claires, des erreurs explicites. Parcourez quelques échanges typiques.
Requête
GET /v1/commandes?statut=expediee&page=1 Authorization: Bearer eyJhbGciOi… Accept: application/json
Réponse 200 OK
{
"donnees": [
{ "numero": "CDE-2026-1187",
"client": "Atelier Dubois",
"statut": "expediee",
"livraison_prevue": "2026-10-16" }
],
"page": 1, "total": 38
}Requête
POST /v1/clients Authorization: Bearer eyJhbGciOi… Content-Type: application/json { "type": "prospect", "nom": "Dupont", "ville": "Bordeaux", "origine": "site-internet" }
Réponse 201 Created
{
"id": 4821,
"type": "prospect",
"nom": "Dupont",
"cree_le": "2026-10-13T10:42:07+02:00"
}
// Donnée invalide ? Une erreur explicite :
// 400 { "erreur": "Le champ « nom » est obligatoire." }Événement envoyé à votre adresse
POST https://votre-outil.fr/webhooks X-Signature: sha256=9f2c41… { "evenement": "devis.signe", "devis": "D-2026-0418", "signe_le": "2026-09-14T16:05:12+02:00" }
Ce que nous garantissons
// Signature vérifiable : l'émetteur est authentique // Nouvel essai automatique en cas d'échec : essai 1 → immédiat essai 2 → +1 min essai 3 → +10 min essai 4 → +1 h // Chaque envoi est journalisé et peut être rejoué
Ce que demande l'utilisateur
« Quels devis de plus de 5 000 € n'ont pas de réponse depuis deux semaines ? » → tools/call chercher_devis { "montant_min": 5000, "sans_reponse_depuis": "14j" }
Ce que l'assistant reçoit OK
[ { "devis": "D-2026-0391", "montant": 7840 },
{ "devis": "D-2026-0402", "montant": 5210 } ]
// L'assistant propose une relance.
// L'envoi attend la confirmation
// explicite de l'utilisateur.Une sécurité éprouvée, sans complication
Avec OAuth 2, un logiciel partenaire accède à vos données sans jamais connaître le mot de passe de l'utilisateur, et l'accès se retire à tout moment.
L'anatomie d'une API solide
Chaque appel traverse plusieurs couches de protection avant de toucher vos données. C'est ce qui permet d'ouvrir vos logiciels sans prendre de risque.
- Versions maintenues : vos partenaires ne cassent jamais
- Erreurs explicites, en français, avec le champ en cause
- Documentation et exemples pour les développeurs partenaires
Des connecteurs pour les assistants IA
Le protocole MCP permet à Claude ou ChatGPT d'utiliser vos logiciels comme le ferait un collaborateur : retrouver un client, préparer un devis, résumer la journée. Nous concevons ces serveurs MCP avec des outils précis et des droits que vous contrôlez.
Notre logiciel Mira expose déjà ses données de cette façon, en production.
Les API que nous intégrons déjà
Nous branchons vos logiciels sur les services dont ils ont besoin. Tous ceux-ci tournent aujourd'hui en production.
- Facturation électroniquePlateforme agréée, Factur-X
- Signature électroniqueEnvoi, suivi, preuve
- Paiement en ligneStripe, abonnements
- Intelligence artificielleClaude, transcription Whisper
- Notifications mobilesFirebase Cloud Messaging
- E-mails transactionnelsAmazon SES
- Stockage de fichiersAmazon S3, à Paris
- CartographieGoogle Maps
Ouvrir votre logiciel, ou en brancher un autre ?
Dites-nous qui doit échanger avec qui. Nous concevons l'API ou l'intégration qui va avec. Voir aussi nos connecteurs entre logiciels.