API

Qu’est-ce qu’une API ?

Une API (Application Programming Interface) est une interface contractuelle permettant à deux systèmes logiciels de communiquer et d’échanger des données — sans avoir à connaître l’implémentation interne de l’autre. Dans le monde B2B cloud moderne, une API se réalise typiquement via REST (Representational State Transfer) ou GraphQL sur le protocole HTTPS, avec des données au format JSON.

Anatomie typique d’un appel API REST :

• Méthode — GET (lecture), POST (création), PUT / PATCH (modification), DELETE (suppression)
• Endpoint — URL, ex. https://api.modulario.eu/v1/invoices/12345
• Authentification — typiquement Bearer token (OAuth 2.0) ou clé API dans l’en-tête
• Corps — payload JSON pour POST/PUT
• Réponse — code de statut HTTP + réponse JSON

Une API bien conçue dispose de :

• Versionnage (/v1/, /v2/) — pour la compatibilité ascendante
• Rate limiting — limitation du nombre d’appels par minute/heure
• Idempotence — un appel répété avec le même identifiant ne crée pas de doublon
• Gestion des erreurs — structures d’erreurs prévisibles
• Pagination — pour les grands jeux de données

Dans un contexte B2B, l’API permet par exemple de connecter une boutique en ligne (WooCommerce, Shopify) à un ERP — une commande du site est automatiquement créée dans l’ERP via l’API, et les niveaux de stock sont synchronisés en retour vers le site.

Quand l’utiliser ?

Une API est aujourd’hui indispensable — sans API ouverte, un ERP/CRM moderne est difficile à vendre car il ne peut pas participer à l’écosystème d’intégrations.

Voir la page API et le module Flux de travail.

Termes associés

• Webhook — notification push depuis une API. Voir /fr/glossaire/webhook.
• SaaS — l’API est l’interface standard du SaaS. Voir /fr/glossaire/saas.
• MCP — couche conviviale pour l’IA au-dessus de l’API. Voir /fr/glossaire/mcp.
• Workflow automation — utilise l’API pour interconnecter les systèmes. Voir /fr/glossaire/workflow-automation.

Dans Modulario

Modulario fournit une API REST complète pour chaque module — authentification via OAuth 2.0 et clés API, rate limiting, idempotence. Documentation, exemples et collections Postman sur /api.

L’API Modulario dispose d’une spécification OpenAPI 3.1 publique, de clients générés automatiquement pour Python, TypeScript, PHP et Java, d’un environnement sandbox pour les tests et d’exemples détaillés pour les scénarios courants (création de facture, synchronisation de clients, téléchargement de rapport).