API TrustService

REST API · v1

TrustService API v1

Utilizza l'API per elencare servizi, creare un ordine, verificare la disponibilità di un SMS, annullare un ordine in attesa e leggere il saldo. Abilita l'accesso API nel tuo account e invia la chiave nell'intestazione della richiesta, non nell'URL.

Il mio account

La tua chiave API

L'API v1 restituisce JSON e consente fino a 60 richieste al minuto per ciascun utente.

X-API-Key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY

GET/api/v1/services

Elenco servizi

Il parametro country è facoltativo. Ogni risultato contiene un ID, un paese, un nome, un prezzo per il cliente e una valuta.

https://trustservice.io/api/v1/services?country=US

POST/api/v1/orders

Crea un ordine

TrustService seleziona automaticamente il numero migliore disponibile per la tua richiesta. Se la prima opzione non è disponibile, il sistema controlla subito la successiva allo stesso prezzo mostrato. Non devi ripetere l’ordine.

Content-Type: application/json

{"service_id": 123}

GET/api/v1/orders/{id}

Stato dell'ordine e SMS

Gli stati possibili sono in attesa, completato e chiuso. Dopo l'arrivo di un SMS, il campo messaggio ne contiene il testo.

https://trustservice.io/api/v1/orders/{order_id}

POST/api/v1/orders/{id}/cancel

Annullare un ordine

https://trustservice.io/api/v1/orders/{order_id}/cancel

GET/api/v1/balance

Saldo

https://trustservice.io/api/v1/balance

HTTP4xx / 5xx

Errori

L'API utilizza codici HTTP standard: 401 chiave non valida o disabilitata, 402 saldo insufficiente, 404 ordine non trovato, 409 ordine o annullamento non riusciti, 422 servizio non valido e 429 limite di tariffa superato.