TrackingMore API

API key

Per usare le API, devi generare una chiave API nel API Keys.Richiedi l'utilizzo gratuito delle API.

The base URL

http://api.trackingmore.com/v2

Header

In order to verify and authenticate your application (e.g. your site), all of the requests that you make to the API must include your unique TrackingMore API Key header (Trackingmore-Api-Key), which you can generate and/or find in the TrackingMore Panel.

Content-Type: application/json
Trackingmore-Api-Key: YOUR_API_KEY

Elenco dei stati della tracciatura.

StringDescription
pendingNuove spedizione aggiunte che sono in attesa di tracciatura.
notfoundL oggetto al momento non è stato trovato.
transitLa spedizione è partita dall origine ed è in viaggio versa la sua destinazione.
pickupL oggetto è in consegna o è arrivato al centro di smistamento alla destinazione. Puoi pianificare la consegna o il ritiro.
deliveredLa spedizione è stata consegnata.
undeliveredIl vettore ha tentato la consegna senza successo. Solitamente viene lasciata una notifica e il vettore proverà a consegnare di nuovo.
exceptionL elemento potrebbe essere in uno stato inusuale, probabilmente l oggetto è stato restituito al mittente, vi sono problemi con le dogane, è andato perduto, danneggiato, eccetera.
expiredL oggetto è in transito da un lungo periodo di tempo e ancora non vi sono esiti sulla consegna.

Risposte tipiche del server

Risponderemo con uno dei seguenti codici di stato

CodeDescription
200OK - La richiesta è avvenuta con successo (Alcune chiamate API potrebbero restituire invece il codice 201).
201Created - La richiesta è avvenuta con successo e una risorsa è stata creata
202Created - La richiesta è avvenuta con successo ma ha ecceduto il limite
401Unauthorized - Autenticazione fallita o non hai i permessi per l operazione richiesta
4001Unauthorized - Chiave API non valida.
4002Unauthorized - La chiave API è stata eliminata
4012Bad Request - La richiesta non è stata interpretata o manca dei parametri richiesti
4013Bad Request - Tracking_number è richiesto.
4014Bad Request - Il numero di 'tracking_number' non è valido.
4015Bad Request - Il valore di 'carrier_code' non è valido.
4016Bad Request - Il codice di tracciatura esiste già.
4017Bad Request - Il codice di tracciatura non esiste.
4018Bad Request - A causa dei rischi di sovraccarico dei server, questa funzione richiede un attivazione specifica. Contattare [email protected] per ulteriori informazioni.
4020Bad Request - Fino a 200 per volta
4021Bad Request - Il tuo credito rimanente non è sufficiente, dunque non puoi usare le richieste API.
4031No Content - La richiesta è avvenuta con successo ma la risposta è vuota.
4032No Content - Non riesco ad identificare il vettore.
4033No Content - The value of `status` is invalid.
402Payment Required - Pagamento richiesto.
403Forbidden - Accesso negato.
404Not Found - La risorsa non è stata trovata.
405Method Not Allowed - Il metodo richiesto non è supportato per la risorsa specificata.
409Conflict - La richiesta non è stata completata a causa di un conflitto.
429Too Many Requests - Limiti API raggiunti. Ferma le richieste, attendi due minuti e quindi prova di nuovo.
500Server error
503Service Unavailable - Il servizio è temporaneamente non disponibile (es: Manutenzione pianificata della piattaforma). Per favore riprova più tardi.

Limitatore del numero di richieste concorrenti

Abbiamo un limitatore delle richieste concorrenti. Nota che se il limite viene superato, verrà inviato un errore 429..

  • Tracciatura in tempo reale: ogni IP, massimo 3 richieste al secondo.

  • Elenca tutte le tracciature: ogni IP, massimo 1 richiesta con fino a 2000 tracciature, al secondo.