API

REST API · v1

TrustService API v1

L’API permet de lister les services, créer une commande, vérifier les SMS, annuler une commande en attente et consulter le solde. Envoyez la clé dans l’en-tête, pas dans l’URL.

Mon compte

Votre clé

L’API v1 renvoie du JSON et autorise 60 requêtes par minute et par utilisateur.

X-API-Key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY

GET/api/v1/services

Lister les services

Le paramètre country est facultatif. La réponse contient l’ID, le pays, le nom, le prix client et la devise.

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

POST/api/v1/orders

Créer une commande

TrustService sélectionne automatiquement le meilleur numéro disponible pour votre demande. Si la première option est indisponible, le système vérifie immédiatement la suivante au même prix affiché. Il est inutile de recommencer la commande.

Content-Type: application/json

{"service_id": 123}

GET/api/v1/orders/{id}

État de la commande et SMS

États possibles : waiting, completed et closed. Le SMS reçu est placé dans message.

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

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

Annuler la commande

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

GET/api/v1/balance

Solde

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

HTTP4xx / 5xx

Erreurs

Codes HTTP : 401 clé invalide, 402 solde insuffisant, 404 introuvable, 409 opération échouée, 422 service invalide et 429 limite dépassée.

API