free numbers

Liste der kostenlosen Nummern abrufen

GEThttps://onlinesim.io/api/getFreeList

Gibt die Länder mit kostenlosen Nummern, die kostenlosen Nummern eines Landes, die von einer davon empfangenen SMS (seitenweise) und die Liste der verbotenen Dienste zurück. Die Antwort hat immer dieselbe Struktur.

  • Ohne Parameter: Land 44, seine erste Nummer.
  • Mit country: dieses Land, seine erste Nummer.
  • Mit country und number: dieses Land und diese Nummer.

Fehlende oder unbekannte Werte führen nie zu einem Fehler: Ein country ohne kostenlose Nummern wird durch das erste Land der Liste ersetzt, eine number, die nicht zu den Nummern des ausgewählten Landes gehört, durch dessen erste Nummer. Was tatsächlich ausgewählt wurde, steht in messages.country und messages.number.

Sie können diese Nummern zum Empfang von SMS verwenden, z. B. zum Testen.

Ein Schlüssel ist nicht nötig. Ein OAuth-Token muss, falls gesendet, free-scope enthalten; ein gesendeter API-Schlüssel wird trotzdem geprüft (ein ungültiger ergibt HTTP 456, ein gesperrtes Konto dessen Fehler). Nur GET wird akzeptiert; dieselbe Methode ist auch unter /api/getFreeList.php erreichbar.

Die Antwort wird pro Parametersatz 5 Sekunden lang gecacht.

Parameter

query8
NameTypBeschreibung
countryinteger

Ländercode (gemäß Länderliste) oder ein Slug bei as_country_text=yes. Der Wert wird in eine Ganzzahl umgewandelt: fehlend, 0 oder nicht numerisch — 44. Ein Land ohne kostenlose Nummern wird stillschweigend durch das erste Land aus countries ersetzt

Standard:44
numberstring

Kostenlose Nummer ohne Ländercode, deren SMS angezeigt werden sollen. Muss genau einer Nummer des ausgewählten Landes entsprechen, sonst wird die erste Nummer dieses Landes verwendet

pageinteger
≥ 1

SMS-Seitennummer. Werte unter 1 oder nicht numerisch — 1; eine Seite hinter dem Ende ergibt ein leeres data

Standard:1
countinteger

Anzahl der SMS pro Seite. Werte unter 10 (und nicht numerische) werden zu 10, Werte über 500 zu 500

Standard:10
as_country_textstring

Wenn yes, ist country ein Länder-Slug (z. B. moldova) statt eines Codes; ein unbekannter Slug bedeutet 44. Jeder andere Wert wird ignoriert

Enumeration:yes
with_contentstring

Wenn yes, enthält content den Seiteninhalt des ausgewählten Landes; andernfalls ist content gleich null. Jeder andere Wert wird ignoriert

Enumeration:yes
localestring

Sprache von content (nur mit with_content=yes verwendet). Standardmäßig gleich lang; eine Sprache ohne Inhalt ergibt ru

langstring

Sprache der Texte in der Antwort (Länder- und Dienstnamen, Statustexte): fr, de, ru, en oder zh. Jede Methode akzeptiert ihn; Methoden ohne solche Texte antworten in jeder Sprache gleich. Feldnamen, Fehlercodes und andere feste Werte bleiben auf Englisch. Ohne den Parameter: ru für getTariffs, getNumbersStats und getFreeList; sonst die Sprache des Profils bei Anfragen mit Schlüssel, Englisch bei Anfragen ohne. Ein nicht unterstützter Wert wird durch die Standardsprache ersetzt

Enumeration:frderuenzh

Antworten

200Kostenlose Länder, Nummern und SMS, ein OAuth-Scope-Fehler oder ein allgemeiner Fehler eines gesendeten Schlüssels
Content-Typeapplication/json
Schema
schemaoneOfErfolgreiche Antwort, ein OAuth-Scope-Fehler oder ein allgemeiner Fehler (nur möglich, wenn ein Schlüssel oder Token gesendet wird)
Eins von
[0]object
[1]object
[2]object

Beispiele

Successful responseZeilen: 79

Gibt eine Liste kostenloser Nummern und der von ihnen empfangenen SMS-Nachrichten zurück

{
  "response": 1,
  "countries": [
    {
      "country": 7,
      "country_text": "Россия",
      "country_original": "russia"
    }
  ],
  "numbers": {
    "9915584911": {
      "country": 7,
      "country_original": "russia",
      "data_humans": "6 days ago",
      "full_number": "79915584911",
      "is_archive": false
    }
  },
  "messages": {
    "current_page": 1,
    "data": [
      {
        "id": 512345678,
        "text": "Your verification code: 482913",
        "in_number": "***2601",
        "my_number": "9915584911",
        "created_at": "2022-07-24T12:32:14.000000Z",
        "data_humans": "1 minute ago",
        "code": "482913"
      }
    ],
    "first_page_url": "https://onlinesim.io/api/getFreeList?page=1",
    "from": 1,
    "last_page": 610,
    "last_page_url": "https://onlinesim.io/api/getFreeList?page=610",
    "links": [
      {
        "url": null,
        "label": "« Previous",
        "active": false
      },
      {
        "url": "https://onlinesim.io/api/getFreeList?page=1",
        "label": "1",
        "active": true
      },
      {
        "url": "https://onlinesim.io/api/getFreeList?page=2",
        "label": "2",
        "active": false
      },
      {
        "url": null,
        "label": "...",
        "active": false
      },
      {
        "url": "https://onlinesim.io/api/getFreeList?page=610",
        "label": "610",
        "active": false
      },
      {
        "url": "https://onlinesim.io/api/getFreeList?page=2",
        "label": "Next »",
        "active": false
      }
    ],
    "next_page_url": "https://onlinesim.io/api/getFreeList?page=2",
    "path": "https://onlinesim.io/api/getFreeList",
    "per_page": 10,
    "prev_page_url": null,
    "to": 10,
    "total": 6100,
    "number": "9915584911",
    "country": 7
  },
  "ignore": "<p>…</p><p>…</p>",
  "content": null
}
freeListOAuthScopeError

Das gesendete OAuth-Token hat keinen free-scope

{
  "response": "Invalid scope(s) provided: free-scope"
}
429HTTP 429: mehr als 400 Anfragen pro Minute von einem Profil (von einer IP bei Anfragen ohne Schlüssel) oder mehr als 200 Anfragen pro Minute von einem Profil an getNum, getPrice, getState und setOperationOk zusammen
Content-Typeapplication/json
Schema
schemaobject
responsestringErforderlich
Fehlercode. Die Codes, die jede Methode liefern kann, stehen in der Einleitung; jede Methode führt ihre eigenen auf. Die Liste ist nicht geschlossen: behandeln Sie einen unbekannten Code als allgemeinen Fehler und protokollieren Sie ihn.

Beispiele

Rate limit

Anfragelimit überschritten

{
  "response": "TRY_AGAIN_LATER"
}
456HTTP 456: Der API-Schlüssel ist ungültig oder das OAuth-Token ist abgelaufen. Öffentliche Methoden antworten genauso, wenn ein ungültiger Schlüssel übergeben wird
Content-Typeapplication/json
Schema
schemaobject
responsestringErforderlich
Fehlercode. Die Codes, die jede Methode liefern kann, stehen in der Einleitung; jede Methode führt ihre eigenen auf. Die Liste ist nicht geschlossen: behandeln Sie einen unbekannten Code als allgemeinen Fehler und protokollieren Sie ihn.

Beispiele

Invalid key

Ungültiger API-Schlüssel oder abgelaufenes Token

{
  "response": "ERROR_WRONG_KEY"
}

Codebeispiele

Beispiele werden generiert...