Connexion

API de vérification SMS

Achat de numéros, récupération du code et annulation en une seule requête HTTP. Avec le format handler_api, très répandu dans le secteur des numéros virtuels, il suffit d'indiquer l'adresse et la clé dans votre programme d'inscription ou votre bot.

Obtenir une clé API

Une fois connecté, créez la clé dans le menu API de l'écran du compte. La clé ne s'affiche qu'une fois à sa création : enregistrez-la aussitôt. L'API utilise le même solde et les mêmes prix que le site.

Adresse de base

https://nuviosms.com/stubs/handler_api.php?api_key=API_KEY&action=...

Requêtes principales

actionRôleExemple de réponse
getBalanceConsulter le soldeACCESS_BALANCE:12.50
getPrices&service=telegram&country=gbPrix et numéros disponibles par service et par pays{"gb":{"telegram":{"cost":0.207,"count":8877728}}}
getNumber&service=telegram&country=gbAchat de numéroACCESS_NUMBER:ID:PHONE
getStatus&id=IDVérifier le codeSTATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8Annuler le numéro (avant le code, remboursement total)ACCESS_CANCEL
setStatus&id=ID&status=3Recevoir un autre code sur le même numéroACCESS_RETRY_GET
setStatus&id=ID&status=6TerminerACCESS_ACTIVATION

Paramètre

NomRequisDescription
api_keyTousClé API créée sur l'écran du compte
actionTousgetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberCode du service (ex. : telegram, whatsapp, google). Identique à l'adresse de sa page dans la liste des services
countrygetNumberCode pays à deux lettres (ex. : gb, us, id)
idgetStatus, setStatusID du numéro renvoyé par getNumber (commence par N-)
statussetStatus8 annuler, 3 nouveau code, 6 terminer, 1 prêt

Texte de réponse et signification

RéponseSignificationArgent
ACCESS_NUMBER:ID:PHONENuméro obtenuLe prix du numéro est débité
STATUS_WAIT_CODEEn attente du codeInchangé
STATUS_OK:CODECode reçuPaiement effectué
STATUS_WAIT_RETRY:CODEEn attente du code suivant (avec le code précédent)Sans frais supplémentaires
STATUS_CANCELAnnulé ou délai écouléRemboursé en l'absence de code
ACCESS_CANCELAnnuléRemboursement total
ACCESS_RETRY_GETEn attente d'un autre code sur le même numéroSans frais supplémentaires
ACCESS_ACTIVATIONUtilisation du numéro terminéeInchangé
NO_BALANCERechargez et recevez tout de suiteNon débité
NO_NUMBERSAucun numéro de ce pays pour le momentNon débité
NO_ACTIVATIONSVous avez 20 numéros ouvertsNon débité
EARLY_CANCEL_DENIEDNuméro avec code : terminez (6) au lieu d'annulerInchangé
BAD_KEYClé API incorrecteNon débité
BAD_SERVICE / BAD_COUNTRYCode de service ou de pays incorrectNon débité
NO_ACTIVATIONID de numéro introuvableInchangé
TOO_MANY_REQUESTSLimite de 300 par minute dépasséeNon débité

Exemples par langage

import time, requests

BASE = "https://nuviosms.com/stubs/handler_api.php"
KEY = "API_KEY"

def call(**p):
    return requests.get(BASE, params={"api_key": KEY, **p}, timeout=30).text

r = call(action="getNumber", service="telegram", country="gb")
if not r.startswith("ACCESS_NUMBER"):
    raise SystemExit(r)
_, num_id, phone = r.split(":")
print("Number:", phone)

for _ in range(240):                      # 20 minutes
    s = call(action="getStatus", id=num_id)
    if s.startswith("STATUS_OK"):
        print("Code:", s.split(":")[1])
        call(action="setStatus", id=num_id, status=6)
        break
    time.sleep(5)

Mode d'emploi

  • Obtenez le numéro avec getNumber, saisissez-le sur l'écran d'inscription, puis appelez getStatus toutes les 5 secondes.
  • STATUS_OK:code : quand le code arrive, saisissez-le et terminez avec setStatus 6.
  • Si aucun code n'arrive sous 20 minutes, le prix du numéro est automatiquement remboursé sur votre solde.
  • Jusqu'à 300 requêtes par minute.