API propria di Get-SMS

Qui è descritto come funziona la nostra API. L'API ti permette di integrare le tue soluzioni software con il nostro servizio, accelerare la verifica degli account ed eliminare il lavoro manuale.

Ricezione del saldo utente

Richiesta GET o POST all'URL:

https://get-sms.com/api/v1/?method=getbalance&userkey=testapikey

Parametri:
method = getbalance
userkey = YOUR_APIKEY

Risposta:
Se la richiesta va a buon fine, viene restituito un json con "status" 200.
La chiave "balance" dell'oggetto "data" indica il saldo attuale:

{
"status": 200,
"data": {
"balance": 100,00
}
}

Codici di errore (status):
500 - errore di elaborazione della richiesta
401 - API KEY utente non specificata o non corretta
404 - parametro method non corretto

Ottenere la lista dei servizi e il numero di numeri disponibili

Se ti serve una lista dei servizi con il loro numero attuale nel sistema, usa questo metodo.

Richiesta GET o POST all'URL:

https://get-sms.com/api/v1/?method=getcount&userkey=testapikey&country=kazakhstan

Parametri:
method = getcount
userkey = YOUR_APIKEY
country = kazakhstan Paese. Parametro facoltativo. Di default è kazakhstan (Kazakhstan). La lista completa dei valori possibili per il Paese è disponibile nella "Lista dei Paesi" sezione

Risposta:
Se la richiesta va a buon fine, viene restituito un json con "status" 200. Il risultato è un oggetto con due chiavi: "status" e "data". La chiave "status" descrive il risultato della richiesta. La chiave "data" contiene un oggetto con le chiavi degli operatori. Ogni chiave operatore contiene un oggetto che descrive i servizi.
Ogni oggetto servizio ha due chiavi: "count" - quantità attuale, e "price" - prezzo.
Questa struttura rende semplice ottenere le informazioni necessarie. Ad esempio, dopo aver decodificato il json in PHP, puoi leggere il numero di WhatsApp per qualsiasi operatore così: $decoded_json['ANY']['wapp']['count'].
I codici di tutti i servizi sono disponibili nella sezione Lista dei servizi.

{
"status": 200,
"data": {
// any operator
"ANY": {
"vk": {
"count": 0,
"price": "5"
},
"ok": {
"count": 0,
"price": "5"
},
"wapp": {
"count": 1,
"price": "2"
},
"vbr": {
"count": 10,
"price": "2"
}
}
...
// Only Tele2
"TELE2": {
...
},
// Only Beeline
"BEELINE": {
...
},
// Only Megafon
"MEGAFON": {
...
},
// Only MTS
"MTS": {
...
}
}
}

Se durante l'esecuzione della richiesta si verifica un errore, viene restituito un json con "status" 500. Il problema è causato da un errore durante il lavoro con il database.
Se ricevi questo errore per questa richiesta, contatta subito la amministrazione del progetto Get-SMS:

{
"status": 500,
"data": {
"msg": "Failed to generate a service count"
}
}

Codici di errore (status):
500 - errore di elaborazione della richiesta
401 - API KEY utente non specificata o non corretta
404 - parametro method non corretto

Ottenere un numero di telefono

La parte principale del progetto è l'assegnazione di numeri di telefono per l'attivazione. Prima di ottenere un numero, controlla di avere abbastanza saldo e che ci siano numeri liberi nel sistema.
Una piccola nota.
Quando viene assegnato un numero, creiamo un ordine virtuale che ti permette di ricevere SMS su quel numero entro 15 minuti. Per tutta la durata dell'ordine, una parte del saldo viene messa in riserva: serve a evitare addebiti errati durante il lavoro multi-thread con l'API e a impedire che l'utente abbandoni l'ordine senza ricevere un SMS.

Richiesta GET o POST all'URL:

https://get-sms.com/api/v1/?method=getnumber&service=vk&userkey=testapikey&country=kazakhstan

Parametri:
method = getnumber
service = vk Servizio. Parametro obbligatorio. La lista completa dei valori dei servizi è disponibile nella "Lista dei servizi" sezione.
userkey = YOUR_APIKEY
country = kazakhstan Paese. Parametro facoltativo. Di default è kazakhstan (Kazakhstan). La lista completa dei valori possibili per il Paese è disponibile nella "Lista dei Paesi" sezione

Risposta:
Se la richiesta va a buon fine, viene restituito un json con la chiave "status" uguale a 200.
La chiave "data" contiene un oggetto con "order_id" - il numero dell'ordine per lavorare poi con il numero di telefono, e "phone" - il numero di telefono per ricevere l'SMS con il codice di verifica.
Il numero di telefono è in formato internazionale con prefisso Paese, senza il segno +. Tienilo presente.

{
"status": 200,
"data": {
"order_id": "377253343",
"phone": "79969817867",
"start_time": "2023-02-23T13:11:57.373Z"
}
}

Può capitare che i numeri per il servizio richiesto siano temporaneamente esauriti; in questo caso lo "status" sarà 500:

{
"status": 500,
"data": {
"msg": "No phone number was found for this request",
"advice": "Please try to retrieve the phone number later, after new numbers become available"
}
}

Codici di errore (status):
401 - API KEY utente non specificata
404 - parametro method non corretto
500 - nessun numero disponibile
502 - il servizio non esiste
503 - l'operatore non esiste
504 - saldo insufficiente
505 - il Paese non esiste
506 - sei temporaneamente bloccato fino al giorno successivo
507 - lavori tecnici in corso

Recuperare un codice da un SMS

Il passaggio finale dell'attivazione è ricevere un codice e il testo completo del messaggio per confermare l'account.
L'algoritmo di ricezione SMS è specifico:
1. invia una richiesta SMS, inserendo nella chiave order_id il valore ricevuto dalla richiesta getnumber.
2. Se "status" è 200, l'SMS è stato ricevuto.
3. Se "status" è 400, l'SMS non è ancora arrivato o non è stato trovato; dopo 5 secondi ripeti dal punto 1.
4. Se "status" è 500, significa che il tempo dell'ordine è scaduto.

Cosa devo fare se l'ordine è scaduto e non ho ricevuto l'SMS?
Può dipendere da vari motivi:
- l'SMS non è stato inviato dal servizio richiesto
- il template di ricerca SMS non è aggiornato
- errore durante il funzionamento delle nostre apparecchiature
- hai inserito per errore un numero di telefono sbagliato.
In ogni caso il denaro non verrà addebitato se non è stato ricevuto alcun SMS.
Se sei sicuro che l'errore sia dovuto a noi, saremo felici di aiutarti tramite supporto tecnico.

Richiesta GET o POST all'URL:

https://get-sms.com/api/v1/?method=getcode&order_id=377253343&userkey=testapikey

Parametri:
method = getcode
order_id = 377253343 Numero d'ordine ottenuto dalla richiesta del numero. Valore obbligatorio.
userkey = YOUR_APIKEY

Risposta:
Se la richiesta va a buon fine, viene ricevuto un json con la chiave "status" uguale a 200.
La chiave "data" contiene un oggetto con i dettagli del messaggio:
code - il codice che il sistema ha trovato nel messaggio. Può essere null se non è stato rilevato
fullSms - il testo completo del messaggio ricevuto
phone - il numero di telefono a cui è stato inviato il messaggio, in formato internazionale senza il segno +
receivedDate - data di ricezione dell'SMS in formato ISO
sender - mittente indicato nel messaggio. Può essere vuoto.
id - identificatore SMS per il metodo wrongcode (SMS aggiuntivo come parametro "last_id")
phonePass - password dell'account personale del fornitore del servizio. Può essere vuota.

{
"status": 200,
"data": {
"code": "753455",
"fullSms": "753455",
"phone": "79969817867",
"receivedDate": "2023-02-23T13:18:57.373Z",
"sender": "",
"id": "377253343",
"phonePass": ""
}
}

Puoi anche ricevere un json con "status" 400: non è un errore, ma una normale risposta del sistema quando il messaggio non è ancora arrivato.
Per continuare, ripeti semplicemente la richiesta del codice dopo 5 secondi.
Va ripetuta finché non ricevi un SMS o finché compare un errore che indica che l'ordine è scaduto (errore 500):

{
"status": 400,
"data": {
"msg": "The SMS has not been found yet",
"advice": "The SMS has probably not been received yet. Please try the request again in 10 seconds"
}
}

Codici di errore (status):
500 - durata ordine scaduta
502 - errore interno, riprova
504 - saldo insufficiente
505 - ordine non trovato nel sistema
506 - parametro order_id non specificato
401 - API KEY utente non specificata
404 - parametro method non corretto

Recuperare il codice

Nel nostro progetto non paghi ogni codice, ma una sorta di noleggio temporaneo di un numero per un servizio specifico. In pratica hai 15 minuti per ricevere tutti i messaggi che arrivano al numero assegnato per il servizio ordinato.
A cosa serve questa funzione? Ad esempio, registri un Qiwi Wallet e devi ricevere un SMS per disattivare una funzione di sicurezza in Qiwi. Ricevi il primo SMS, registri il wallet, disattivi la funzione di sicurezza in Qiwi, ci invii la richiesta wrongcode e noi ti diamo il secondo SMS da Qiwi gratis. Non c'è limite al numero di SMS aggiuntivi che puoi ricevere all'interno dell'ordine.
ATTENZIONE!
Puoi ricevere codici aggiuntivi solo durante la durata dell'ordine, cioè entro 15 minuti dalla ricezione del numero.

Richiesta GET o POST all'URL:

https://get-sms.com/api/v1/?method=wrongcode&order_id=377253343&userkey=testapikey&last_id=377253343

Parametri:
method = wrongcode
order_id = 377253343 Numero d'ordine ottenuto dalla richiesta del numero. Valore obbligatorio.
userkey = YOUR_APIKEY
last_id = 377253343 Identificatore dell'ultimo SMS ricevuto tramite getcode o precedente richiesta wrongcode. Quasi sempre coincide con order_id, ma può essere diverso: fai attenzione. Valore obbligatorio.

{
"status": 200,
"data": {
"code": "753455",
"fullSms": "753455",
"phone": "79969817867",
"receivedDate": "2023-02-23T13:18:57.373Z",
"sender": "",
"id": "377253343",
"phonePass": ""
}
}

{
"status": 400,
"data": {
"msg": "The SMS has not been found yet",
"advice": "The SMS has probably not been received yet. Please try the request again in 10 seconds"
}
}

Codici di errore (status):
500 - durata ordine scaduta
501 - parametro method non corretto
502 - errore interno, riprova la richiesta
504 - non hai ancora ricevuto il primo SMS dal metodo getcode.
505 - ordine non trovato nel sistema
506 - parametro order_id non specificato
401 - API KEY utente non specificata
404 - parametro method errato

Annullare l'ordine del numero

Se hai ricevuto un numero ma, per motivi tuoi, vuoi annullare l'ordine, devi eseguire l'annullamento del numero usando il metodo refusenumber.

Richiesta GET o POST all'URL:

https://get-sms.com/api/v1/?method=refusenumber&order_id=377253343&userkey=testapikey

Parametri:
method = refusenumber
order_id = 377253343 Numero d'ordine ottenuto dalla richiesta del numero. Valore obbligatorio.
userkey = YOUR_APIKEY

Risposta:
Se la richiesta va a buon fine, viene restituito il json con la chiave "status" impostata a 200:

{
"status": 200,
"data": {
"msg": "The phone number order has been canceled"
}
}

Se ricevi un messaggio diverso, consulta i codici di errore qui sotto.

Codici di errore (status):
500 - durata ordine scaduta
502 - errore interno, riprova
506 - parametro order_id non specificato
401 - API KEY utente non specificata
404 - parametro method errato

Bloccare il numero di telefono

Se durante la registrazione dell'account scopri che il numero ricevuto non è adatto alla registrazione, ti consigliamo di usare il metodo bannumber per bloccare il numero.

Richiesta GET o POST all'URL:

https://get-sms.com/api/v1/?method=bannumber&order_id=377253343&userkey=testapikey

Parametri:
method = bannumber
order_id = 377253343 Numero d'ordine ottenuto dalla richiesta del numero. Valore obbligatorio.
userkey = YOUR_APIKEY

Risposta:
Se la richiesta va a buon fine, viene restituito il json con la chiave "status" impostata a 200:

{
"status": 200,
"data": {
"msg": "The phone number is banned"
}
}

Ottenere tutti i valori di Paesi e servizi disponibili

Il nostro nuovo metodo permette di recuperare i valori di tutti i Paesi e di tutti i servizi disponibili in ogni Paese.
Il metodo permette anche di indicare un servizio specifico e ottenere quantità e prezzi per tutti i Paesi per quel servizio.

Richiesta GET o POST all'URL:

https://get-sms.com/api/v1/?method=getallcount&service=tg&userkey=testapikey

Parametri:
method = getallcount
service = tg Parametro facoltativo. Se non indicato, il metodo restituirà tutti i Paesi e tutti i servizi
userkey = YOUR_APIKEY

Risposta:
Se la richiesta va a buon fine, viene restituito un json senza il parametro service:

{
"kazakhstan": [
  {
   "vk": {
    "name": "VK",
    "price": "62.3",
    "count_all": "3712"
   },
   "wa": {
    "name": "Whatsapp",
    "price": "195",
    "count_all": "3740"
   },
   "vi": {
    "name": "Viber",
    "price": "6.55",
    "count_all": "3876"
   },
   "tg": {
    "name": "Telegram",
    "price": "209.49",
    "count_all": "3861"
   },
"ask": {
    "name": "SVOE",
    "price": "8.98",
    "count_all": "3525"
   }
  }
],
"england": [
  {
   "vk": {
    "name": "VK",
    "price": "2.28",
    "count_all": "3909"
   },
   "ok": {
    "name": "Ok.ru",
    "price": "38.2",
    "count_all": "4026"
   },
"atp": {
    "name": "Vonage",
    "price": "2.13",
    "count_all": "3979"
   }
  }
],
...
}

OPPURE:
Se la richiesta va a buon fine, viene restituito un json con il parametro service:

{
"kazakhstan": {
"price": "214.15",
"count_all": "4036"
},
"england": {
"price": "98.67",
"count_all": "3654"
},
"canada": {
"price": "28.57",
"count_all": "3970"
},
"germany": {
"price": "295.73",
"count_all": "1499"
},
"ssha": {
"price": "41.03",
"count_all": "4459"
},
"brazil": {
"price": "178.28",
"count_all": "4157"
},
...
}

Se ricevi un messaggio diverso, consulta i codici di errore qui sotto.

Codici di errore (status):
502 - errore interno, riprova la richiesta
401 - API KEY utente non specificata
404 - parametro method impostato in modo non corretto

API compatibile con altri servizi di attivazione

Se scegli di lavorare in compatibilità con un altro servizio di attivazione e non vuoi riscrivere il tuo software, puoi usare la nostra API compatibile. Però lo sconsigliamo vivamente, perché non viene aggiornata né supportata correttamente.
La prima cosa da fare per iniziare a usare la nostra API compatibile è aprire il file hosts in Windows, che si trova a questo indirizzo
C:\Windows\System32\drivers\etc\
e aggiungere la seguente riga:
5.253.63.28 domain.com (il nome dominio di un altro servizio di attivazione)

Se non vuoi modificare il file hosts, cambia nel tuo software il dominio dell'altro servizio di attivazione con get-sms.com. L'indirizzo delle richieste dovrà avere questa forma:
https://get-sms.com/stubs/handler_api.php
Puoi inviare tutte le richieste sia in POST sia in GET.
Tieni presente che l'inoltro chiamate non è ancora disponibile e molto probabilmente non sarà disponibile in questa versione dell'API.
Per il resto, tutte le nostre API compatibili sono identiche. Abbiamo quindi copiato le istruzioni per non creare confusione negli utenti.

Richiesta del numero di numeri disponibili (getNumbersStatus)

Richiesta GET o POST all'URL:

https://get-sms.com/stubs/handler_api.php?action=getNumbersStatus&api_key=testapikey&country=2

Parametri:
action = getNumbersStatus
api_key = YOUR_APIKEY
country = 2 Paese. Parametro facoltativo. Di default è 2 (Kazakhstan). La lista completa dei valori possibili per il Paese è disponibile nella "Lista dei Paesi" sezione

Risposta:
Se la richiesta va a buon fine, riceverai un json di questo tipo:

{
"vk_0": 28,
"ok_0": 4,
"wa_0": 9,
"vi_0": 19,
"tg_0": 30,
"wb_0": 21,
"go_0": 30,
"av_0": 8,
"av_0": 23,
"fb_0": 24
}

Richiesta saldo (getBalance)

Richiesta GET o POST all'URL:

https://get-sms.com/stubs/handler_api.php?action=getBalance&api_key=testapikey

Parametri:
action = getBalance
api_key = YOUR_APIKEY

Risposta:
Se la richiesta va a buon fine, riceverai un TEXT di questo tipo:

ACCESS_BALANCE:100 // dove 100 è il tuo saldo attuale in USD

Possibili errori:
BAD_KEY - Invalid API key
ERROR_SQL - SQL server error

Ordine di un numero di telefono (getNumber)

Richiesta GET o POST all'URL:

https://get-sms.com/stubs/handler_api.php?action=getNumber&service=vk&country=2&api_key=testapikey

Parametri:
action = getNumber
service = vk Servizio. Parametro obbligatorio. La lista completa dei valori dei servizi è disponibile nella "Lista dei servizi" sezione.
maxPrice = 25 Optional. The maximum price in your account currency you agree to pay for the number. Without it the number is sold only at the lowest available price; with it, when no numbers are available at the lowest price, more expensive offers are tried automatically up to maxPrice. You are charged the actual price of the sold number, never more than maxPrice. Available price levels: getPrices with tiers=1.
country = 2 Paese. Parametro facoltativo. Di default è 2 (Kazakhstan). La lista completa dei valori possibili per il Paese è disponibile nella "Lista dei Paesi" sezione
api_key = YOUR_APIKEY

Risposta:
Se la richiesta va a buon fine, riceverai un TEXT di questo tipo, dove $id è l'id della transazione e $number è il numero di telefono:

ACCESS_NUMBER:$id:$number

Altre risposte:
NO_NUMBERS - nessun numero disponibile
NO_BALANCE - nessun saldo
WRONG_MAX_PRICE:$minPrice - maxPrice is lower than the minimum available price (the minimum available price is returned after the colon)

Possibili errori:
BAD_ACTION - invalid action
BAD_SERVICE - invalid service name
WRONG_SERVICE - The service is not in the system
BAD_KEY - Invalid API key
ERROR_SQL - SQL server error
YOU_TEMPORARY_BANNED - You are banned until the next day

Modifica dello stato di attivazione (setStatus)

Richiesta GET o POST all'URL:

https://get-sms.com/stubs/handler_api.php?action=setStatus&status=1&id=1234567&api_key=testapikey

Parametri:
action = setStatus
status = STATUS CODE I possibili codici di stato sono elencati qui sotto
id = OPERATION ID Order ID ricevuto dalla richiesta getNumber
api_key = YOUR_APIKEY

Possibili stati:
1 notifica che il numero è pronto (messaggio inviato al numero)
3 richiedi un altro codice (gratis)
6 completa attivazione Se lo stato era 'code received', segnalo come riuscito e completa. Se lo stato era 'preparing', eliminalo e segnalo come errore. Se lo stato era 'waiting for retry', cambia l'attivazione in 'in attesa di SMS'.
8 segnala che il numero è stato usato e annulla l'attivazione.

Risposta:
Se la richiesta va a buon fine, riceverai TEXT in base allo stato:

ACCESS_READY - the readiness of the number has been confirmed
ACCESS_RETRY_GET - waiting for a new SMS
ACCESS_ACTIVATION - service successfully activated
ACCESS_CANCEL - attivazione annullata

Possibili errori:
BAD_ACTION - invalid action
NO_ACTIVATION - activation id does not exist
BAD_STATUS - Incorrect status
BAD_KEY - Invalid API key
ERROR_SQL - SQL server error

Ottieni stato attivazione (getStatus)

Richiesta GET o POST all'URL:

https://get-sms.com/stubs/handler_api.php?action=getStatus&id=1234567&api_key=testapikey

Parametri:
action = getStatus
id = OPERATION ID Order ID ricevuto dalla richiesta getNumber
api_key = YOUR_APIKEY

Risposta:
Se la richiesta va a buon fine, riceverai TEXT in base allo stato:

STATUS_WAIT_CODE - in attesa di SMS
STATUS_WAIT_RETRY:'The previous code that did not work' - in attesa di ulteriori chiarimenti sul codice
STATUS_WAIT_RESEND - in attesa che l'sms venga reinviato (il software deve premere resend sms e cambiare lo stato in 6)
STATUS_CANCEL - attivazione annullata
STATUS_OK: 'activation code' - codice ricevuto

Possibili errori:
BAD_ACTION - invalid action
NO_ACTIVATION - activation id does not exist
NO_BALANCE - insufficient balance
BAD_KEY - Invalid API key
ERROR_SQL - SQL server error

Ottieni tutti i prezzi dei servizi (getPrices)

Richiesta GET o POST all'URL:

https://get-sms.com/stubs/handler_api.php?action=getPrices&api_key=testapikey&service=SERVICE&country=2

Parametri:
action = getPrices
service = vk Servizio. Parametro facoltativo. La lista completa dei valori dei servizi è disponibile nella "Lista dei servizi" sezione.
api_key = YOUR_APIKEY
tiers = 1 Optional. With tiers=1 the response contains all available price levels for each service (several "price": count pairs sorted by price) instead of a single minimum price. Use these prices as maxPrice in getNumber.
country = 2 Paese. Parametro obbligatorio. Di default è 2 (Kazakhstan). La lista completa dei valori possibili per il Paese è disponibile nella "Lista dei Paesi" sezione

Risposta:
Se la richiesta va a buon fine, riceverai un json di questo tipo:

{
"0": {
"vk": {
"25": 36
},
"lb": {
"25": 169
},
"wa": {
"51": 178
},
"vi": {
"2.96": 0
},
"tg": {
"38.8": 0
},
"wb": {
"6.56": 3580
},
"go": {
"7.87": 4433
},
"av": {
"6.69": 3595
},
"fb": {
"3.94": 3932
},
"qw": {
"20": 3759
}
}
}

La gerarchia ha questa forma - { "Paese": { "Servizio": { "Prezzo": { "Quantità"}}}

tiers=1 — response example (all available price levels per service):

{
"2": {
"tg": {
"38.8": 120,
"45.5": 340,
"52": 1210
},
"vk": {
"25": 36
}
}
}

API per noleggio a lungo termine di numeri telefonici

Questa sezione descrive come lavorare con l'API per il noleggio di un numero di telefono. L'API ti permette di integrare le tue soluzioni software con il nostro servizio.
Per qualsiasi domanda puoi sempre contattare il supporto.

Il server API accetta richieste POST e GET
Le richieste vengono inviate a questo indirizzo - https://get-sms.com/api/v2/rent/rent_number.php

Ottenere numeri disponibili, servizi e prezzi di noleggio

Richiesta GET o POST all'URL:

https://get-sms.com/api/v2/rent/rent_number.php?method=getdatacountry&country=KZ

Parametri:
method = getdatacountry
country = KZ Paese. Parametro obbligatorio. La lista completa dei possibili valori Paese può essere ottenuta dalla richiesta "richiesta per recuperare tutti i Paesi"

Risposta:
Se la richiesta va a buon fine, viene restituita una risposta JSON con la chiave "status" uguale a 200.
La chiave "data" conterrà un oggetto con servizi, prezzi, numero di numeri disponibili e operatori:
1xbet (esempio) - un oggetto con chiave del codice servizio e con il numero di telefoni disponibili per il noleggio e i prezzi per un periodo specifico
qty - numero di telefoni disponibili
price_day - prezzo per 1 giorno di noleggio del numero
operators - operatori disponibili

{
"status": 200,
"data": {
"country": {
"code": "KZ",
"name": "Kazakhstan",
"icon": "/uploads/country_img/Kazakhstan.png",
"available_numbers": 6714
  },
  "operators": [
{
"id": "49",
"name": "Aktiv_Kazakhstan",
"codename": "Aktiv_Kazakhstan"
}
  ],
  "services": [
{
"id": 1,
"name": "1xbet",
"img": "/uploads/service_img/1xbet.png",
"price_day": 69.72,
"qty": 57
},
...
]
}
}

Ottenere un numero di telefono a noleggio

Dopo la creazione del noleggio del numero, non è previsto alcun rimborso, anche se cambi idea, rifiuti di usare il numero o per altri motivi non legati all'impossibilità tecnica di fornire il servizio.

Richiesta GET o POST all'URL:

https://get-sms.com/api/v2/rent/rent_number.php?userkey=testapikey&method=createorder&type=week&period=1&services=82,1,4&country=KZ&operator=ANY

Parametri:
method = createorder
userkey = YOUR_APIKEY
type = weekParametro obbligatorio. Tipo di periodo: week (settimane) o month (mese).
period = 1 Numero di settimane o mesi. Parametro obbligatorio. Il valore 1 e il tipo periodo week indicano che vogliamo noleggiare il numero per 1 settimana.
services = 82,1,4 Servizi (con ID 82, 1 e 4). Parametro obbligatorio. La lista completa dei valori servizio è disponibile nella "Lista dei servizi di noleggio".
country = KZ Country. Required parameter. A full list of possible country values can be obtained from the "Lista dei Paesi per il noleggio"
operator = ANY Operatore mobile. Parametro facoltativo. La lista degli operatori può essere ottenuta dalla richiesta della lista Paesi o della lista servizi

Risposta:
Se la richiesta va a buon fine, viene restituita una risposta JSON con la chiave "status" uguale a 200.
La chiave "data" conterrà un oggetto con la chiave "order_id", cioè il numero d'ordine per lavorare poi con il numero di telefono, e la chiave "phone", che contiene il numero di telefono per ricevere SMS con codici di verifica.
Il numero viene assegnato in formato internazionale con prefisso Paese e senza il segno +. Tienilo presente.

Per comodità, gli intervalli di tempo sono indicati come timestamp UNIX e nel formato standard a 24 ore:
end_time_timestamp - timestamp UNIX fino alla fine del noleggio
end_time - data e ora di fine del noleggio del numero
start_timestamp - data e ora di inizio del noleggio come timestamp UNIX

{
"status": 200,
"data": {
"order_id": 123,
"country_code": "+7",
"phone": "79991234567",
"end_time_timestamp": 1771234567,
"end_time": "18.02.2026 14:30",
"start_timestamp": 1768642567,
"orders_count": 1,
"order_ids": [123]
}
}

Codici di errore (status):
401 - Errore nel parametro userkey
402 - Errore nel parametro country
404 - Paese non trovato
502 - Errore nel parametro services
504 - Tipo di periodo non corretto
506 - Periodo non corretto per il tipo settimana/mese
504 - Impossibile ottenere una risposta dal server
503 - Errore interno del server. Invia la richiesta più tardi
507 - manutenzione tecnica in corso

Recuperare tutti gli SMS sul numero noleggiato

Richiesta GET o POST all'URL:

https://get-sms.com/api/v2/rent/rent_number.php?method=getsms&userkey=testapikey&rentid=888

Parametri:
method = getsms
userkey = YOUR_APIKEY
rentid= 888 Parametro obbligatorio. Order ID ricevuto dalla richiesta per ottenere un numero a noleggio. Questo parametro si trova anche nella richiesta per recuperare tutti gli ordini attivi.

Risposta:
Se la richiesta va a buon fine, viene restituita una risposta JSON con la chiave "status" uguale a 200.
La chiave "data" conterrà un oggetto con la chiave "sms_list", che contiene tutti gli SMS ricevuti su questo numero.

{
"status": 200,
"data": {
"msg": "List of all SMS messages",
"sms_list": [
{
"date": "2026-05-21 14:30:00",
"text": "Your code: 123456",
"timestamp": 1779363000
},
{
"date": "2026-05-21 14:35:00",
"text": "Your code: 45345345",
"timestamp": 1779363500
}
]
}
}

Puoi anche ricevere una risposta JSON con "status" 200. Non è un errore: è una normale risposta del sistema quando il noleggio è scaduto.

{
"status": 200,
"data": {
"msg": "Rent is not active, SMS refresh was skipped",
"can_reload_sms": false,
"status_rent": 0,
"sms_list": []
}
}

Codici di errore (status):
401 - API KEY utente non specificata
404 - Ordine di noleggio non trovato
504 - Impossibile ottenere una risposta dal server
502 - ID noleggio non specificato

Estendere l'ordine di noleggio

Richiesta GET o POST all'URL:

https://get-sms.com/api/v2/rent/rent_number.php?userkey=testapikey&method=prolong&type=week&period=1&rentid=888

Parametri:
method = prolong
userkey = YOUR_APIKEY
type = week Required parameter. Period type: week (weeks) or month (month).
period = 1 Numero di settimane o mesi. Parametro obbligatorio. Il valore 1 e il tipo periodo week indicano che vogliamo estendere il numero per 1 settimana.
rentid= 888 Parametro obbligatorio. Order ID ricevuto dalla richiesta per ottenere un numero a noleggio. Questo parametro si trova anche nella richiesta per recuperare tutti gli ordini attivi.

Risposta:
Se la richiesta va a buon fine, viene restituita una risposta JSON con la chiave "status" uguale a 200. Significa che l'estensione del numero è stata completata correttamente.

{
"status": 200,
"data": {
"msg": "Rental successfully extended",
"order_id": 888,
"days": 7,
"price": 350,
"rent_at": 1779967800,
"rent_at_formatted": "2026-05-28 14:30:00"
}
}

Codici di errore (status):
401 - Errore nel parametro userkey
504 - Tipo di periodo non corretto
506 - Periodo non corretto per il tipo settimana/mese
504 - Impossibile ottenere una risposta dal server
503 - Errore interno del server. Invia la richiesta più tardi
507 - Manutenzione tecnica in corso

Recuperare tutti i Paesi per il noleggio

Richiesta GET o POST all'URL:

https://get-sms.com/api/v2/rent/rent_number.php?method=countries

Parametri:
method = countries

Risposta:
Se la richiesta va a buon fine, viene restituita una risposta JSON con la chiave "status" uguale a 200, con la lista di tutti i Paesi disponibili e dei relativi operatori mobili

{
"status": 200,
"data": {
"countries": [
{
"code": "AT",
"name": "Austria",
"available_numbers": 93,
"operators": [
{
"id": 30,
"name": "Tele2",
"codename": "Tele2_AT",
"available_numbers": 93
}
]
   },
   {
"code": "AR",
"name": "Argentina",
"available_numbers": 3969,
"operators": [
{
"id": 25,
"name": "Claro",
"codename": "Claro_AR",
"available_numbers": 3969
}
]
},
   {
"code": "BE",
"name": "Belgium",
"available_numbers": 2363,
"operators": [
{
"id": 69,
"name": "Lycamobile",
"codename": "Lycamobile_BE",
"available_numbers": 2363
}
]
}
],
  "count": 33
}
}

Recuperare tutti gli ordini di noleggio

Richiesta GET o POST all'URL:

https://get-sms.com/api/v2/rent/rent_number.php?userkey=testapikey&method=allorders

Parametri:
method = allorders
userkey = YOUR_APIKEY

Risposta:
Se la richiesta va a buon fine, viene restituita una risposta JSON con un array di tutti i numeri noleggiati ordinati, inclusi i numeri il cui noleggio è stato annullato o completato.
Significato della chiave status:
status = 0 Il periodo di noleggio del numero è scaduto
status = 1 Il noleggio è attivo

{
"status": 200,
"data": {
"msg": "List of all orders",
"orders": [
{
"id": 123,
"phone": "77991234567",
"number_phone": "77991234567",
"status_rent": 1,
"status_label": "Active",
"can_reload_sms": true,
"service_name": "Telegram",
"country_code": "KZ",
"country_name": "Kazakhstan",
"code_country_phone": "+7",
"operator": "Aktiv_KZ",
"price_day": 50,
"total_price": 350,
"period_price": 7,
"rent_from": 1779363000,
"rent_at": 1779967800,
"date_from": "2026-05-21 14:30:00",
"date_at": "2026-05-28 14:30:00",
"userkey": "USERKEY"
}
],
"count": 1
}
}

Se non ci sono numeri noleggiati, riceverai un array vuoto:

{
"status": 200,
"data": {
"msg": "List of all orders",
"orders": [],
"count": 0
}
}

Lista dei Paesi

Valore	Nome	Valore API compatibile
kazakhstan	Kazakhstan	2
england	England	16
canada	Canada	36
germany	Germany	43
usavirt	USA (Virtual)	12
brazil	Brazil	73
estonia	Estonia	34
france	France	78
indonesia	Indonesia	6
kyrgyzstan	Kyrgyzstan	11
laos	Laos	25
lithuania	Lithuania	44
netherlands	Netherlands	48
poland	Poland	15
romania	Romania	32
sweden	Sweden	46
indiia	India	22
malaiziia	Malaysia	7
vetnam	Vietnam	10
filippiny	Philippines	4
turtsiia	Turkey	62
moldova	Moldova	85
uzbekistan	Uzbekistan	40
gruziia	Georgia	128
irlandiia	Ireland	23
portugaliia	Portugal	117
ispaniia	Spain	56
chekhiia	Czech Republic	63
bangladesh	Bangladesh	60
ssha	USA	187
ukr	Ukraine	1
gonkong	Hong Kong	14
tailand	Thailand	52
meksika	Mexico	54
latviia	Latvia	49
pakistan	Pakistan	66
gretsiia	Greece	129
nikaragua	Nicaragua	90
argentina	Argentina	39
gaiti	Haiti	26
mongoliia	Mongolia	72
izrail	Israel	13
egipet	Egypt	21
gvatemala	Guatemala	94
liviia	Libya	102
iran	Iran	57
iemen	Yemen	30
tadzhikistan	Tajikistan	143
kitai	China	3
shrilanka	Sri Lanka	64
siriia	Syria	110
livan	Lebanon	153
boliviia	Bolivia	92
serbiia	Serbia	29
kolumbiia	Colombia	33
avstriia	Austria	50
alzhir	Algeria	58
peru	Peru	65
gonduras	Honduras	88
marokko	Morocco	37
venesuela	Venezuela	70
nigeriia	Nigeria	19
iamaika	Jamaica	103
salvador	Salvador	101
botsvana	Botswana	123
paragvai	Paraguay	87
nepal	Nepal	81
uganda	Uganda	75
irak	Iraq	47
iordaniia	Jordan	116
mianma	Myanmar	5
demkongo	Dem.Congo	18
keniia	Kenya	8
kambodzha	Cambodia	24
belarus	Belarus	51
kotdivuar	Ivory Coast	27
saudaraviia	Saud. Arabia	53
oae	UAE	95
khorvatiia	Croatia	45
papuanovaiagvineia	Papua New Guinea	79
tanzaniia	Tanzania	9
gvineia	Guinea	68
mali	Mali	69
kamerun	Cameroon	41
mavritaniia	Mauritania	114
serraleone	Sierra Leone	115
burkinafaso	Burkina Faso	152
daniia	Denmark	172
tunis	Tunisia	89
dominikanskaiarespublika	Dominican Republic	109
iuzhnaiaafrika	South Africa	31
ekvador	Ecuador	105
liberiia	Liberia	135
senegal	Senegal	61
afganistan	Afghanistan	74
novaiazelandiia	New Zealand	67
chad	Chad	42
angola	Angola	76
gana	Ghana	38
iuzhnaiakoreia	South Korea	190
sudan	Sudan	98
taivan	Taiwan	55
zimbabve	Zimbabwe	96
turkmenistan	Turkmenistan	161
reiunon	Reunion	146
kipr	Cyprus	77
gaiana	Guyana	131
maldivy	Maldives	159
mozambik	Mozambique	80
gambiia	Gambia	28
trinidaditobago	Trinidad and Tobago	104
gabon	Gabon	154
brunei	Brunei	121
butan	Bhutan	158
surinam	Suriname	142
armeniia	Armenia	148
benin	Benin	120
mavrikii	Mauritius	157
fidzhi	Fiji	189
kongo	Congo	150
dominika	Dominica	126
bermudy	Bermuda	195
aruba	Aruba	179
chili	Chili	151
finliandiia	Finland	163
italiia	Italy	86
bolgariia	Bulgaria	83
vengriia	Hungary	84
sloveniia	Slovenia	59
khorvatiia	Croatia	45
norvegiia	Norway	174

Lista dei servizi

Valore	Nome
ai	CELEBe
do	Leboncoin
dh	EBay
sk	Skroutz
lq	Potato
mh	Ashan
wv	AIS
ia	Socios
bf	Keybase
mm	Microsoft
qd	Taobao
at	Perfluence
qf	RedBook
dp	ProtonMail
mi	Zupee
yb	Quartet+
wa	Whatsapp
uz	OffGamers
ou	Gabi
he	Mewt
jj	Aitu
ez	GoerliFaucet
ts	PayPal
ta	Wink
qt	MoneyControl
ef	Nextdoor
ad	Iti
cg	Gemgala
nu	Stripe
rf	Akudo
kj	YAPPY
ul	Getir
nv	Naver
fw	99acres
ud	Disney Hotstar
lw	MrGreen
io	ZdravCity
oy	CashFly
qm	RosaKhutor
mn	RRSA
dt	Delivery Club
lt	BitClout
ui	RuTube
qw	Qiwi
fj	Potato Chat
tx	Bolt
kc	Vinted
xd	Tokopedia
pp	Huya
qj	Whoosh
qh	Oriflame
jt	TurkiyePetrolleri
ok	Ok.ru
wk	Mobile01
bn	Alfagift
wh	TanTan
vm	OkCupid
ri	BillMill
bs	TradeUP
tw	Twitter
ey	Miloan
je	Nanovest
hr	JKF
kn	Verse
yf	Citymobil
aj	OneAset
bx	Dosi
ca	SuperS
gr	Astropay
rv	Kotak811
bp	GoFundMe
ni	Gojek
fy	Mylove
dk	Pairs
bk	G2G
bb	LazyPay
vo	Brand20ua
bh	Uteka
gz	LYKA
ww	BIP
ur	MyDailyCash
cx	Icrypex
sh	VkusVill
gv	Humta
ve	Dream11
kp	HQ Trivia
uf	Eneba
aa	Probo
tk	MVideo
iq	Icq
ej	MrQ
ss	Hezzl
sf	SneakersnStuff
ce	Mosru
dc	YikYak
sl	SberApteka
dl	Lazada
uo	CafeBazaar
uh	Yubo
pl	Perekrestok
dg	Mercari
cb	Bazos
pu	Justdating
gh	GyFTR
ev	Picpay
qg	MoneyPay
bw	Signal
cc	Quipp
jf	Likee
eq	Qoo10
dd	CloudChat
jc	IVI
er	Kwork
ip	Burger King
bu	MonobankIndia
nq	Trip
qi	23red
eg	ContactSys
cp	Uklon
sg	OZON
xr	Tango
uk	Airbnb
ko	AdaKami
nf	Netflix
vy	Meta
dy	Zomato
ha	My11Circle
tg	Telegram
dq	IceCasino
rs	Lotus
bc	GCash
ne	Coindcx
mr	Fastmail
we	DrugVokrug
ry	McDonalds
qa	MyFishka
pm	AOL
la	Ssoidnet
ak	Douyu
go	Google,youtube,Gmail
oi	Tinder
dn	Paxful
xl	Wmaraci
vz	Hinge
rd	Lenta
wb	WeChat
ew	Nike
gm	Mocospace
wj	1xbet
xe	GalaxyChat
sn	OLX
ae	MyGLO
ch	Pocket52
py	Monese
hn	1688
qy	Zhihu
ck	BeReal
kw	Foody
ml	ApostaGanha
ci	RedBus
wc	Craigslist
pd	IFood
be	SberMegaMarket
xy	Depop
cf	Irancell
wp	163COM
rx	Sheerid
su	LOCO
ho	Cathay
af	GalaxyWin
bq	Adani
oq	Vlife
ru	HOP
om	Corona
sb	Lamoda
ig	Instagram
uj	ChampionCasino
mu	MyMusicTaste
cq	Mercado
ti	Cryptocom
uu	Wildberries
ub	Uber
ln	Grofers
me	Line msg
of	Urent
fz	KFC
un	Humblebundle
ug	Fiqsy
kr	Eyecon
vn	Yaay
qe	GG
ds	Discord
gg	PagSmile
uw	Kirana
vs	WinzoGame
gt	Gett
uy	Meliuz
hq	Magicbricks
im	Imo
bv	Metro
po	Premium.one
jg	Grab
es	IQIYI
bo	Wise
kb	Kufarby
wq	Leboncoin1
jh	PingPong
tt	Ziglu
rr	Wolt
ih	TeenPattiStarpro
od	FWDMAX
iv	Inboxlv
xh	OVO
ra	KeyPay
bz	Blizzard
rc	Skype
pt	Bitaqaty
gu	Fora
ma	Mail.ru
ji	Monobank
op	MIRATORG
hk	4Fun
gp	Ticketmaster
up	Magnolia
dr	OpenAI
bd	X5ID
gl	GlobalTel
gx	Hepsiburadacom
ay	Ruten
sr	Starbucks
pa	Gamekit
ct	KuhnyaNaRayone
ht	Bitso
ft	Bookmakers
ka	Shopee
mx	SoulApp
wt	IZI
sw	NCsoft
ep	Temu
mc	Michat
qr	MEGA
ee	Twilio
le	E bike Gewinnspiel
ec	RummyCulture
qu	Agroinform
oh	MapleSEA
fa	XadrezFeliz
cm	Prom
bt	Alfa
ya	Yandex
ot	Any other
cj	Dotz
hh	Uplay
gc	TradingView
sm	YoWin
ki	99app
tu	Lyft
de	Karusel
pq	CDkeys
fm	Touchance
lr	Okta
ly	Olacabs
va	SportGully
df	Happn
kf	Weibo
vc	Banqi
fk	BLIBLI
xn	Familia
th	WestStein
fs	Şikayet var
rz	EasyPay
cn	Fiverr
dx	Powerkredite
pg	NRJ Music Awards
bg	MIXMART
mj	Zalo
xw	Taki
ua	BlaBlaCar
pf	Pof.com
an	Adidas
mk	LongHu
lh	24betting
hg	Switips
sq	KuCoinPlay
lx	DewuPoison
gf	GoogleVoice
iy	FoodHub
nz	Foodpanda
ah	EscapeFromTarkov
nw	Ximalaya
sj	HandyPick
et	Clubhouse
tl	Truecaller
md	Banks
co	Rediffmail
ga	Roposo
oc	DealShare
og	Okko
rh	Ace2Three
rl	InDriver
dj	LUKOIL-AZS
pr	Trendyol
bj	Vita Express
rk	Fotka
ao	UU163
nr	Tosla
ph	SnappFood
ar	Wondermart
ij	Revolut
qc	Primaries 2020
gd	Surveytime
ky	SpatenOktoberfest
sp	HappyFresh
xj	SberMarket
ac	DoorDash
ba	Expressmoney
kz	NimoTV
np	Siply
vf	Q12 Trivia
tf	Noon
iz	Global24
jz	Kaya
yd	米画师Mihuashi
cl	UWIN
fx	PGbonus
jr	Scooter
px	Nifty
nl	Myntra
tn	LinkedIN
dw	Divar
ke	Eldorado
ku	RoyalWin
el	Bisu
bm	MarketGuru
nn	Giftcloud
lp	Algida
eo	Sizeer
cw	PaddyPower
gw	CallApp
wo	Parkplus
si	Cita Previa
xt	Flipkart
wx	Apple
qz	Faceit
di	Loanflix
kx	Vivo
nb	Faithful
xi	InFund
pw	SellMonitor
fb	Facebook
ex	Linode
st	Ashan
mt	Steam
av	Avito
db	Ezbuy
wn	GameArena
sa	AGIBANK
re	Coinbase
no	Virgo
ls	Careem
ql	CMTcuzdan
tm	Akulaku
rb	Tick
ei	Taksheel
hc	MOMO
qk	Bit
gs	SamsungShop
lf	TikTok/Douyin
vd	Betfair
so	RummyWealth
wl	YouGotaGift
yx	JTExpress
vj	Stormgain
sv	Dostavista
ob	Onlinerby
rp	Hamrahaval
tc	Rambler
vx	HeyBox
ab	Alibaba
eh	Telegram 2.0
jm	Mzadqatar
fo	MobiKwik
az	CityBase
ny	Pyro Music
xu	RecargaPay
yk	SportMaster
zw	Quack
lv	Megogo
fh	Lalamove
ja	Weverse
xq	MPL
lc	Subito
ea	JamesDelivery
qn	Blued
ib	Immowelt
wg	Skout
ff	AVON
jx	Swiggy
au	Haraj
uv	BinBin
eb	Voltz
ju	Indomaret
kt	KakaoTalk
km	Rozetka
yg	CourseHero
cd	SpotHit
xk	DiDi
qo	Moneylion
sd	Dodopizza
fe	CliQQ
ed	Gamer
bi	勇仕网络Ys4fun
yz	Around
xf	LightChat
tj	DbrUA
mf	Weidian
rg	Porbet
xv	Wish
mb	Yahoo
mg	Magnet
gi	Hotline
hm	Globus
ol	KazanExpress
xb	RummyOla
vk	Vkontakte
hw	Alipay/Alibaba
oz	Poshmark
tq	Swvl
fc	PharmEasy
ue	Onet
aq	Glovo
mq	GMNG
my	CAIXA
vw	CoinField
dm	Iwplay
fg	IndianOil
xs	GroupMe
hx	AliExpress
yj	EWallet
eu	LiveScore
cy	RSA
us	IRCTC
br	Vkusno i Tochka
jb	Wing Money
fl	RummyLoot
fr	Dana
aw	Taikang
zh	Zoho
zj	ROBINHOOD
zi	LoveLocal
yp	Payzapp
zd	Zilch
yo	Amasia
zs	Bilibili
zm	OfferUp
yw	Grindr
yy	Venmo
zl	Airtel
yl	Yalla
zn	Biedronka
fv	Vidio
fu	Snapchat
cr	TenChat
hi	JungleeRummy
nk	Gittigidiyor
vv	Seosprint
dv	NoBroker
hl	Band
ll	888casino
hb	Twitch
vp	Kwai
td	ChaingeFinance
xz	Paycell
li	Baidu
lj	Santander
xx	Joyride
yq	Foxtrot
mo	Bumble
ge	Paytm
lb	Mailru Group
zq	IndiaPlays
ik	GuruBets
cu	炙热星河
oe	Codashop
kh	Bukalapak
sy	Brahma
vi	Viber
os	Dhani
uc	Tatneft
ym	Yula
rm	Faberlic
cv	WashXpress
pz	Lidl
kl	Kolesa.kz
gj	Carousell
zf	OnTaxi
gb	YouStar
en	Hermes
jl	Hopi
hy	Ininal
ax	CrefisaMais
iu	Bykea
fi	Dundle
gk	AptekaRU
rt	Hily
cz	Getmega
dz	Dominos Pizza
fd	Mamba
kg	FreeChargeApp
il	IQOS
hz	Drom
xm	Létoile
qq	Tencent QQ
tp	IndiaGold
am	Amazon
qb	Payberry
hu	Ukrnet
em	ZéDelivery
vg	ShellBox
tr	Paysend
cs	AgriDevelop
lk	PurePlatfrom
rj	Kids' World
wf	YandexGo
zu	BigC
jq	Paysafecard
nm	Thisshop
bl	BIGO LIVE
sz	Pivko24
hj	Stoloto
da	MTS CashBack
du	AUBANK
yn	Allegro
zo	Kaggle
zv	Digikala
yu	Xiaomi
yv	IPLwin
zg	Setel
yi	Yemeksepeti
zk	Deliveroo
zt	Budweiser
zr	Papara
zz	Dent
zx	CommunityGaming
zy	Nttgame
ys	ZCity
za	JDcom
call	Receiving a reset call