Le API servono a chi ha un programma proprio: chiede i prezzi, compra le etichette e scarica i file senza passare dal pannello. Serve qualcuno che sappia programmare.
Le API servono a chi ha un programma proprio: chiede i prezzi, compra le etichette e scarica i file senza passare dal pannello. Serve qualcuno che sappia programmare.
Circa 20 minuti, per chi programma
Premi Nuova chiave, dalle un nome e scegli solo i permessi che servono.
Si vede una volta sola. Conservala nel tuo gestionale, mai in una pagina web e mai in un'email.
Usa il primo esempio qui sotto, al posto di LA_TUA_CHIAVE. Serve il permesso Chiedere preventivi.
Usa il secondo esempio con l'id del preventivo. Spende il credito: Idempotency-Key evita di pagare due volte se ripeti la richiesta.
Usa il terzo esempio con l'id della spedizione. Poi stampa al 100 per cento, senza adattare alla pagina.
In Sviluppatori, Webhook, indichi un indirizzo del tuo sistema: ti avvisiamo noi e firmiamo ogni messaggio.
curl https://www.spediamo-facile.it/api/v1/quotes \
-H "Authorization: Bearer LA_TUA_CHIAVE" \
-H "Content-Type: application/json" \
-d '{
"kind": "manual",
"sender": { "name": "Magazzino", "address": "Via Roma 1", "postalCode": "20121", "city": "Milano", "province": "MI", "country": "IT", "phone": "0200000000", "email": "magazzino@example.com" },
"consignee": { "name": "Anna Bianchi", "address": "Via Verdi 2", "postalCode": "00184", "city": "Roma", "province": "RM", "country": "IT", "phone": "0600000000", "email": "anna@example.com" },
"parcels": [{ "weight": 1500, "length": 300, "width": 200, "height": 100 }]
}'curl https://www.spediamo-facile.it/api/v1/shipments \
-H "Authorization: Bearer LA_TUA_CHIAVE" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: ordine-1234-tentativo-1" \
-d '{ "quoteId": "ID_DEL_PREVENTIVO" }'curl https://www.spediamo-facile.it/api/v1/shipments/ID_DELLA_SPEDIZIONE/label \ -H "Authorization: Bearer LA_TUA_CHIAVE" \ -o etichetta.pdf
curl https://www.spediamo-facile.it/api/v1/orders/single \
-H "Authorization: Bearer LA_TUA_CHIAVE" \
-H "Content-Type: application/json" \
-d '{ "externalId": "GEST-1001", "recipientName": "Anna Bianchi", "address": "Via Verdi 2", "postalCode": "00184", "city": "Roma", "province": "RM", "country": "IT", "phone": "0600000000", "email": "anna@example.com", "productTitle": "Maglia", "quantity": 2, "weight": "0,5" }'Se il primo esempio restituisce le offerte, chiave e permessi sono giusti.
Una chiave Solo per le prove non spende credito vero. Passa a una chiave Solo per il reale quando tutto funziona.
Ogni chiave mostra quando è stata usata l'ultima volta.
La chiave è sbagliata, scaduta o revocata. Controlla di averla copiata intera e che segua la parola Bearer.
La chiave non ha il permesso per quella chiamata. Creane una nuova con il permesso giusto.
Un dato non è valido. La risposta dice quale: il peso è in grammi, le misure in millimetri.
L'acquisto non parte finché non ricarichi il portafoglio.
La funzione è spenta per ora. Scrivi all'assistenza.
Grammi per il peso e millimetri per le misure, in numeri interi.
Con il permesso di acquistare, chi ha la chiave può comprare etichette. Puoi fissare un limite di spesa al giorno e revocarla in ogni momento.
Mandare due volte lo stesso externalId aggiorna l'ordine e non crea doppioni: è l'idempotenza degli ordini, senza bisogno di altro.