API TrustService

REST API · v1

TrustService API v1

Użyj interfejsu API, aby wyświetlić listę usług, utworzyć zamówienie, sprawdzić wiadomość SMS, anulować zamówienie oczekujące i odczytać saldo. Włącz dostęp API na swoim koncie i wyślij klucz w nagłówku żądania, a nie w adresie URL.

Moje konto

Twój klucz API

API v1 zwraca JSON i pozwala na maksymalnie 60 żądań na minutę dla każdego użytkownika.

X-API-Key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY

GET/api/v1/services

Lista usług

Parametr kraj jest opcjonalny. Każdy wynik zawiera identyfikator, kraj, nazwę, cenę klienta i walutę.

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

POST/api/v1/orders

Utwórz zamówienie

TrustService automatycznie wybiera najlepszy dostępny numer dla Twojego żądania. Jeśli pierwsza opcja jest niedostępna, system od razu sprawdza następną w tej samej wyświetlanej cenie. Nie musisz ponawiać zamówienia.

Content-Type: application/json

{"service_id": 123}

GET/api/v1/orders/{id}

Status zamówienia i SMS

Możliwe statusy to oczekiwanie, ukończone i zamknięte. Po odebraniu wiadomości SMS pole message zawiera jej treść.

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

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

Anuluj zamówienie

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

GET/api/v1/balance

Bilans

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

HTTP4xx / 5xx

Błędy

API wykorzystuje standardowe kody HTTP: 401 nieprawidłowy lub wyłączony klucz, 402 niewystarczające saldo, 404 nie znaleziono zamówienia, 409 zamówienie lub anulowanie nie powiodło się, 422 nieprawidłowa usługa i przekroczony limit stawki 429.