Panoramica
Le API di Amica sono servizi RESTful accessibili tramite normali client HTTP oppure tramite gli SDK ufficiali e i client generati dalla nostra specifica OpenAPI.
L'Amica Cloud API espone i dati aziendali dei clienti — anagrafiche, documenti, magazzino, scadenze e fatturazione elettronica — ovvero gran parte delle funzionalità disponibili nell'applicazione web Amica 20.
Se sei uno sviluppatore e vuoi creare integrazioni o applicazioni complete che interagiscono con Amica 20 e con i dati sottostanti, questo è il posto giusto.
Primi passi
- Registra la tua app sull'App Store di Amica e ottieni le
credenziali OAuth (
client_ideclient_secret). - Scegli e implementa il metodo di autenticazione più adatto.
- Segui il Quickstart del tuo linguaggio preferito, oppure prova l'API con curl o Postman.
- Esplora gli endpoint e i modelli nella API Reference interattiva.
Concetti fondamentali
Queste guide descrivono i meccanismi trasversali a tutta l'API:
- Company ID e multi-azienda — come indirizzare le chiamate alla giusta azienda.
- Paginazione — navigare le liste con
Skip/Take. - Ordinamento e filtri — recuperare solo i dati che ti servono.
- Espansione oggetti correlati — includere inline le entità collegate.
- Gestione errori — codici di stato e Problem Details RFC 7807.
- Controllo della concorrenza — aggiornare in sicurezza con il
ConcurrencyToken. - Rate limiting — limiti di richiesta e header standard.