API

Cos’è un’API?

API (Application Programming Interface) è un’interfaccia concordata attraverso la quale due sistemi software possono comunicare e scambiarsi dati — senza dover conoscere l’implementazione interna dell’altro. Nel moderno mondo cloud B2B, le API si realizzano tipicamente tramite REST (Representational State Transfer) o GraphQL sul protocollo HTTPS, con dati in formato JSON.

Anatomia tipica di una chiamata REST API:

• Metodo — GET (lettura), POST (creazione), PUT / PATCH (modifica), DELETE (eliminazione)
• Endpoint — URL, es. https://api.modulario.eu/v1/invoices/12345
• Autenticazione — tipicamente Bearer token (OAuth 2.0) o API key nell’header
• Body — JSON payload per POST/PUT
• Risposta — codice di stato HTTP + risposta JSON

Un’API ben progettata ha:

• Versioning (/v1/, /v2/) — per la retrocompatibilità
• Rate limiting — limitazione del numero di chiamate al minuto/ora
• Idempotenza — una chiamata ripetuta con lo stesso ID non crea duplicati
• Error handling — strutture di errore prevedibili
• Paginazione — per dataset di grandi dimensioni

Nel contesto B2B italiano, l’API consente ad esempio di collegare un e-commerce (WooCommerce, Shopify) all’ERP — un ordine dall’e-commerce viene automaticamente creato nell’ERP tramite API, e le giacenze di magazzino vengono sincronizzate di ritorno sul sito.

Quando si utilizza

L’API è oggi una necessità — senza un’API aperta, un moderno software ERP/CRM difficilmente riesce a partecipare all’ecosistema delle integrazioni.

Vedi la pagina API, il modulo Flussi di lavoro e le integrazioni.

Termini correlati

• Webhook — notifica push dall’API. Vedi /it/glossario/webhook.
• SaaS — l’API è l’interfaccia standard del SaaS. Vedi /it/glossario/saas.
• MCP — strato AI-friendly sopra le API. Vedi /it/glossario/mcp.
• Workflow automation — utilizza le API per collegare i sistemi. Vedi /it/glossario/workflow-automation.

In Modulario

Modulario offre un’API REST completa per ogni modulo — autenticazione via OAuth 2.0 e chiavi API, rate limiting, idempotenza. Documentazione, esempi e collezioni Postman su /api.

L’API di Modulario dispone di una specifica OpenAPI 3.1 pubblica, client generati automaticamente per Python, TypeScript, PHP e Java, un ambiente sandbox per i test e esempi dettagliati per gli scenari tipici (creazione fattura, sincronizzazione clienti, download report).