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
countryundnumber: 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
| Name | Typ | Beschreibung |
|---|---|---|
country | integer | Ländercode (gemäß Länderliste) oder ein Slug bei
Standard: 44 |
number | string | 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 |
page | integer≥ 1 | SMS-Seitennummer. Werte unter 1 oder nicht numerisch — 1; eine Seite hinter dem Ende ergibt ein leeres Standard: 1 |
count | integer | Anzahl der SMS pro Seite. Werte unter 10 (und nicht numerische) werden zu 10, Werte über 500 zu 500 Standard: 10 |
as_country_text | string | Wenn Enumeration: yes |
with_content | string | Wenn Enumeration: yes |
locale | string | Sprache von |
lang | string | Sprache der Texte in der Antwort (Länder- und Dienstnamen, Statustexte): Enumeration: frderuenzh |
Antworten
200Kostenlose Länder, Nummern und SMS, ein OAuth-Scope-Fehler oder ein allgemeiner Fehler eines gesendeten Schlüssels
application/jsonschemaoneOfErfolgreiche Antwort, ein OAuth-Scope-Fehler oder ein allgemeiner Fehler (nur möglich, wenn ein Schlüssel oder Token gesendet wird)
[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
}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
application/jsonschemaobject
Beispiele
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
application/jsonschemaobject
Beispiele
Ungültiger API-Schlüssel oder abgelaufenes Token
{
"response": "ERROR_WRONG_KEY"
}