Springe zuErste Schritte

API-Referenz

Kaufe virtuelle Nummern, Mietnummern, Google-Voice-Nummern und Geschenkkarten aus deinem eigenen Code. Jeder Aufruf ist eine GET-Anfrage mit deinem Schlüssel in der Query und wird mit demselben Guthaben bezahlt wie auf der Website.

Basis-URLhttps://smsonline.io/api/v1

Lieber durchklicken? Die Postman-Sammlung enthält jeden Aufruf sendebereit.

Antworten und Fehler

Erfolgreiche Aufrufe liefern "status": 1 mit dem Ergebnis in data. Alles andere bedeutet, dass der Aufruf nichts bewirkt hat: Den Grund findest du in msg.

1: Erfolg
-1: Fehlgeschlagen. Es wurde nichts belastet, sofern msg nichts anderes sagt
-2: SMS noch nicht empfangen. Weiter abfragen

Fehlerantwort

{
  "status": -1,
  "error": "missing parameter",
  "msg": ["Insufficient inventory"]
}

Konto

Prüfe das Guthaben, mit dem jeder Kauf bezahlt wird.

Guthaben abrufen

GET/get-balance

Liefert das aktuelle Guthaben in USD.

Query-Parameter

apiKeyerforderlichDein API-Schlüssel

curl -G "https://smsonline.io/api/v1/get-balance" \
  -d apiKey=YOUR_API_KEY

Beispielantwort

{
  "status": 1,
  "data": { "balance": "24.60" }
}

Virtuelle Nummern

Einmalnummern für die SMS-Verifizierung. Finde ein Produkt, kaufe es und frage dann den Code ab.

Länder auflisten

GET/virtual-number/get-countries

Alle Länder, in denen du eine Nummer kaufen kannst. Verwende deren id als countryId.

Query-Parameter

apiKeyerforderlichDein API-Schlüssel

curl -G "https://smsonline.io/api/v1/virtual-number/get-countries" \
  -d apiKey=YOUR_API_KEY

Beispielantwort

{
  "status": 1,
  "data": [
    { "id": 1, "name": "United States", "image": "https://…/us.png" },
    { "id": 7, "name": "United Kingdom", "image": "https://…/gb.png" }
  ]
}

Dienste auflisten

GET/virtual-number/get-services

Alle Apps, für die du einen Code empfangen kannst. Verwende deren id als serviceId.

Query-Parameter

apiKeyerforderlichDein API-Schlüssel

curl -G "https://smsonline.io/api/v1/virtual-number/get-services" \
  -d apiKey=YOUR_API_KEY

Beispielantwort

{
  "status": 1,
  "data": [
    { "id": 2, "name": "Telegram", "image": "https://…/telegram.png" },
    { "id": 5, "name": "WhatsApp", "image": "https://…/whatsapp.png" }
  ]
}

Produkte auflisten

GET/virtual-number/get-products

Preise für eine App in einem Land, eine Zeile pro Betreiber (operatorId 1 bis 4) mit der günstigsten Nummer dieses Betreibers. Betreiber kommen und gehen mit dem Bestand, kaufe also nur bei einer operatorId, die dieser Aufruf gerade geliefert hat.

Query-Parameter

apiKeyerforderlichDein API-Schlüssel
countryIderforderlichLänder-ID aus „Länder auflisten“
serviceIderforderlichDienst-ID aus „Dienste auflisten“

curl -G "https://smsonline.io/api/v1/virtual-number/get-products" \
  -d apiKey=YOUR_API_KEY \
  -d countryId=1 \
  -d serviceId=2

Beispielantwort

{
  "status": 1,
  "data": [
    { "countryId": 1, "serviceId": 2, "operatorId": 1, "price": "0.45" },
    { "countryId": 1, "serviceId": 2, "operatorId": 3, "price": "0.72" },
    { "countryId": 1, "serviceId": 2, "operatorId": 4, "price": "0.64" }
  ]
}

Nummer kaufen

Belastet dein Guthaben

GET/virtual-number/buy-service

Kauft eine Nummer beim gewählten Betreiber zu dem Preis, den „Produkte auflisten“ geliefert hat, und belastet dein Guthaben. Die Nummer bleibt 10 Minuten aktiv.

Query-Parameter

apiKeyerforderlichDein API-Schlüssel
countryIderforderlichLänder-ID
serviceIderforderlichDienst-ID
operatorIderforderlichBetreiber-ID (1 bis 4) aus „Produkte auflisten“

curl -G "https://smsonline.io/api/v1/virtual-number/buy-service" \
  -d apiKey=YOUR_API_KEY \
  -d countryId=1 \
  -d serviceId=2 \
  -d operatorId=1

Beispielantwort

{
  "status": 1,
  "data": {
    "order_id": 918273,
    "Number": "+14155550132",
    "country_name": "United States",
    "service_name": "Telegram",
    "country_image": "https://…/us.png",
    "service_image": "https://…/telegram.png"
  }
}

SMS-Code abrufen

GET/virtual-number/get-sms

Frage alle paar Sekunden ab, bis der Code ankommt. status: -2 bedeutet: noch nicht. Kommt keine SMS rechtzeitig an, schlägt die Bestellung fehl und der Preis geht zurück auf dein Guthaben.

Query-Parameter

apiKeyerforderlichDein API-Schlüssel
orderIderforderlichorder_id aus „Nummer kaufen“

curl -G "https://smsonline.io/api/v1/virtual-number/get-sms" \
  -d apiKey=YOUR_API_KEY \
  -d orderId=918273

Beispielantwort

{
  "status": 1,
  "code": "48213"
}

// still waiting
{ "status": -2, "error": "Sms not received", "msg": ["sms for this number is not received"] }

Google Voice

Fertige US-Google-Voice-Nummern mit ihrem Google-Konto.

Nummern auflisten

GET/google-voice/get-numbers

Die aktuell verfügbaren Nummern mit ihrem Preis.

Query-Parameter

apiKeyerforderlichDein API-Schlüssel

curl -G "https://smsonline.io/api/v1/google-voice/get-numbers" \
  -d apiKey=YOUR_API_KEY

Beispielantwort

{
  "status": 1,
  "data": [
    { "id": 3321, "number": "+1 (628) 555-0147", "price": "4.90", "type": 1, "country_name": "USA" }
  ]
}

Eine Nummer abrufen

GET/google-voice/get-number

Eine Nummer aus der Liste, anhand ihrer ID.

Query-Parameter

apiKeyerforderlichDein API-Schlüssel
iderforderlichNummern-ID aus „Nummern auflisten“

curl -G "https://smsonline.io/api/v1/google-voice/get-number" \
  -d apiKey=YOUR_API_KEY \
  -d id=3321

Beispielantwort

{
  "status": 1,
  "data": { "id": 3321, "number": "+1 (628) 555-0147", "price": "4.90", "type": 1, "country_name": "USA" }
}

Nummer kaufen

Belastet dein Guthaben

GET/google-voice/buy-number

Kauft die Nummer, erstellt die Bestellung und belastet dein Guthaben.

Query-Parameter

apiKeyerforderlichDein API-Schlüssel
iderforderlichNummern-ID aus „Nummern auflisten“

curl -G "https://smsonline.io/api/v1/google-voice/buy-number" \
  -d apiKey=YOUR_API_KEY \
  -d id=3321

Beispielantwort

{
  "status": 1,
  "data": { "order_id": 918274, "number": "+1 (628) 555-0147" }
}

Nummer mieten

Behalte eine Nummer für Stunden, Tage, Wochen oder Monate und empfange jede an sie gesendete SMS.

Mietdauern auflisten

GET/rent-number/get-durations

Die wählbaren Mietzeiträume und die jeweils erlaubten Mengen.

Query-Parameter

apiKeyerforderlichDein API-Schlüssel

curl -G "https://smsonline.io/api/v1/rent-number/get-durations" \
  -d apiKey=YOUR_API_KEY

Beispielantwort

{
  "status": 1,
  "data": [
    { "type": "hour", "time": [1, 2, 4, 8, 12] },
    { "type": "day", "time": [1, 2, 3, 4, 5, 6, 7] }
  ]
}

Länder auflisten

GET/rent-number/get-countries

Länder, in denen du mieten kannst, mit Preisen für den angefragten Zeitraum.

Query-Parameter

apiKeyerforderlichDein API-Schlüssel
typeerforderlichhour, day, week oder month
timeerforderlichWie viele Einheiten dieses Zeitraums

curl -G "https://smsonline.io/api/v1/rent-number/get-countries" \
  -d apiKey=YOUR_API_KEY \
  -d type=day \
  -d time=3

Beispielantwort

{
  "status": 1,
  "type": "day",
  "time": "3",
  "data": [ { "id": 1, "name": "United States", "price": "2.85" } ]
}

Nummer mieten

Belastet dein Guthaben

GET/rent-number/buy-number

Erstellt eine ausstehende Miete und belastet dein Guthaben. Die Nummer wird zugewiesen, wenn die Bestellung abgeschlossen ist.

Query-Parameter

apiKeyerforderlichDein API-Schlüssel
countryIderforderlichLänder-ID aus „Länder auflisten“
typeerforderlichhour, day, week oder month
timeerforderlichWie viele Einheiten dieses Zeitraums

curl -G "https://smsonline.io/api/v1/rent-number/buy-number" \
  -d apiKey=YOUR_API_KEY \
  -d countryId=1 \
  -d type=day \
  -d time=3

Beispielantwort

{
  "status": 1,
  "data": { "order_id": 918275, "status": "pending", "type": "day", "time": "3" }
}

Geschenkkarten

Codes für Spiele, Shops und Streaming. Bestellungen werden von unserem Team bestätigt, dann erscheint der Code.

Geschenkkarten auflisten

GET/giftcard/get-list

Alle Geschenkkarten im Verkauf.

Query-Parameter

apiKeyerforderlichDein API-Schlüssel

curl -G "https://smsonline.io/api/v1/giftcard/get-list" \
  -d apiKey=YOUR_API_KEY

Beispielantwort

{
  "status": 1,
  "data": [
    { "id": 12, "brand": "Steam", "name": "Steam $20 US", "face_value": "20.00",
      "selling_price": "21.40", "currency_code": "USD", "category_name": "Games" }
  ]
}

Eine Geschenkkarte abrufen

GET/giftcard/get-detail

Alle Details einer Geschenkkarte.

Query-Parameter

apiKeyerforderlichDein API-Schlüssel
iderforderlichGeschenkkarten-ID aus „Geschenkkarten auflisten“

curl -G "https://smsonline.io/api/v1/giftcard/get-detail" \
  -d apiKey=YOUR_API_KEY \
  -d id=12

Beispielantwort

{
  "status": 1,
  "data": { "id": 12, "brand": "Steam", "name": "Steam $20 US", "selling_price": "21.40" }
}

Geschenkkarte kaufen

Belastet dein Guthaben

GET/giftcard/buy

Erstellt eine ausstehende Bestellung und belastet dein Guthaben. Der Code wird hinzugefügt, sobald die Bestellung bestätigt ist.

Query-Parameter

apiKeyerforderlichDein API-Schlüssel
iderforderlichGeschenkkarten-ID

curl -G "https://smsonline.io/api/v1/giftcard/buy" \
  -d apiKey=YOUR_API_KEY \
  -d id=12

Beispielantwort

{
  "status": 1,
  "data": { "order_id": 918276, "order_status": "pending" }
}

Bestellstatus abrufen

GET/giftcard/order-status

Frage eine Bestellung ab. Wenn order_status den Wert complete hat, sind Code und Seriennummer enthalten.

Query-Parameter

apiKeyerforderlichDein API-Schlüssel
orderIderforderlichorder_id aus „Geschenkkarte kaufen“

curl -G "https://smsonline.io/api/v1/giftcard/order-status" \
  -d apiKey=YOUR_API_KEY \
  -d orderId=918276

Beispielantwort

{
  "status": 1,
  "data": { "order_id": 918276, "order_status": "complete", "code": "XXXX-XXXX-XXXX", "serial": "8812…" }
}