Client
Per lavorare con l'Amica Cloud API serve un client capace di interagire con essa. Puoi usare uno dei nostri SDK ufficiali, generare un client nel tuo linguaggio dalla specifica OpenAPI, oppure usare un client HTTP generico come curl o Postman.
SDK ufficiali
Gli SDK ufficiali sono generati automaticamente dalla specifica OpenAPI
dell'Amica Cloud API e aggiornati a ogni rilascio, così restano sempre allineati all'API.
Ognuno espone i modelli e i metodi dell'API e gestisce serializzazione e chiamate HTTP;
a tuo carico resta solo l'autenticazione (header
Authorization: Bearer <token>).
| Linguaggio | Pacchetto | Repository |
|---|---|---|
| C# / .NET | Amica.Sdk |
amica-dev/csharp-sdk |
| Python | amica_python_sdk |
amica-dev/python-sdk |
| TypeScript | @amica/typescript-sdk |
amica-dev/typescript-sdk |
| PHP | amica/php-sdk |
amica-dev/php-sdk |
Le istruzioni di installazione e d'uso si trovano nel README di ciascun repository.
Generare un client per altri linguaggi
Se il tuo linguaggio non è tra quelli sopra, puoi generare un client tipizzato dalla specifica OpenAPI con OpenAPI Generator (supporta decine di linguaggi):
openapi-generator-cli generate \
-i https://customerws1.amica20.it/api/v3/swagger.json \
-g <linguaggio> \
-o ./amica-client
Strumenti per provare l'API
- curl — chiamate HTTP da riga di comando.
- Postman — importa la specifica OpenAPI e provala dall'interfaccia grafica.
- API Reference interattiva — prova gli endpoint direttamente dal browser.