API

REST API · v1

TrustService API v1

Mit der API können Sie Dienste auflisten, Bestellungen anlegen, SMS prüfen, wartende Bestellungen stornieren und das Guthaben abrufen. Senden Sie den Schlüssel im Header, nicht in der URL.

Ihr Schlüssel

API v1 liefert JSON und erlaubt 60 Anfragen pro Minute und Benutzer.

X-API-Key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY
GET/api/v1/services

Dienste auflisten

Der Parameter country ist optional. Das Ergebnis enthält ID, Land, Name, Kundenpreis und Währung.

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

Bestellung anlegen

TrustService wählt automatisch die beste verfügbare Nummer für Ihre Anfrage. Ist die erste Option nicht verfügbar, prüft das System sofort die nächste zum gleichen angezeigten Preis. Eine manuelle Wiederholung ist nicht nötig.

Content-Type: application/json

{"service_id": 123}
GET/api/v1/orders/{id}

Bestellstatus und SMS

Mögliche Status sind waiting, completed und closed. Die SMS steht anschließend in message.

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

Bestellung stornieren

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

Guthaben

https://trustservice.io/api/v1/balance
HTTP4xx / 5xx

Fehler

HTTP-Codes: 401 Schlüssel ungültig, 402 Guthaben zu niedrig, 404 nicht gefunden, 409 Vorgang fehlgeschlagen, 422 Dienst ungültig, 429 Limit überschritten.