VioSMS Öffentliche API

Authentifizierung

Authentifizieren Sie Ihre Anfragen, indem Sie Ihren API-Schlüssel in den Authorization-Header aufnehmen.

HTTP Header

Authorization: Bearer YOUR_API_KEY

GET/api/v1/balance

Gibt Ihr aktuelles Kontoguthaben zurück.

Antwort

{
  "status": "success",
  "balance": 15.50,
  "currency": "USD"
}

GET/api/v1/services

Gibt eine Liste aller verfügbaren Dienste und deren Mindestpreise zurück.

Hinweis: Wenn Sie nach einem bestimmten Dienst wie Hinge oder Tinder suchen, verwenden Sie diesen Endpunkt, um alle verfügbaren Dienstcodes dynamisch abzurufen.

Antwort

{
  "status": "success",
  "data": [
    {
      "code": "wa",
      "name": "WhatsApp",
      "price": 0.25
    }
  ]
}

GET/api/v1/countries

Rufen Sie eine Liste aller verfügbaren Länder und ihrer Codes ab. Sie müssen den code aus dieser Antwort verwenden, wenn Sie eine Nummer kaufen.

Antwort

{
  "status": "success",
  "data": [
    {
      "code": "turkey",
      "name": "Turkey"
    },
    {
      "code": "62",
      "name": "Indonesia"
    }
  ]
}

POST/api/v1/buy

Kauft eine neue Telefonnummer. Die Kosten werden von Ihrem Guthaben abgezogen.

Parameter	Integrieren Sie VioSMS in Ihre Anwendungen, um Nummern automatisch zu kaufen. Alle API-Endpunkte erfordern einen API-Schlüssel.
servicestring*	Service-Code (z. B. "wa" für WhatsApp).
countrystring*	Ländercode (z. B. "161" für die Türkei).
operatorstring	Optionaler Operator-Code. Standard ist "any".

Anfrage

{
  "service": "wa",
  "country": "161"
}

Antwort

{
  "status": "success",
  "data": {
    "id": "cuid...",
    "phone": "+1234567890",
    "price": 1.25,
    "expiresAt": "2026-06-05T12:00:00.000Z"
  }
}

GET/api/v1/status

Überprüft den SMS-Verifizierungsstatus einer Aktivierung.

Parameter	Integrieren Sie VioSMS in Ihre Anwendungen, um Nummern automatisch zu kaufen. Alle API-Endpunkte erfordern einen API-Schlüssel.
idstring*	Die eindeutige Aktivierungs-ID, die beim Kauf zurückgegeben wurde.

Antwort

{
  "status": "success",
  "data": {
    "id": "cuid...",
    "status": "SMS_RECEIVED",
    "phone": "+1234567890",
    "smsCode": "456789",
    "smsText": "WhatsApp code: 456789"
  }
}

POST/api/v1/cancel

Storniert eine Aktivierung und erstattet die Kosten, wenn keine SMS empfangen wurde.

Parameter	Integrieren Sie VioSMS in Ihre Anwendungen, um Nummern automatisch zu kaufen. Alle API-Endpunkte erfordern einen API-Schlüssel.
idstring*	Die eindeutige Aktivierungs-ID zum Stornieren.

Anfrage

{
  "id": "cuid..."
}

Antwort

{
  "status": "success",
  "message": "Activation cancelled and refunded"
}