API de vérification SMS

Achat du numéro, lecture du code et annulation avec une seule requête HTTP. Au format handler_api, très répandu dans le secteur des numéros virtuels : ajoutez simplement l'adresse et la clé à 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 tout de suite. L'API utilise le même solde et les mêmes prix que le site.

Adresse de base

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

Principales requêtes

actionCe que nous faisonsExemple de réponse
getBalanceVoir le soldeACCESS_BALANCE:12.50
getPrices&service=telegram&country=krPrix et numéros disponibles par service{"kr":{"telegram":{"cost":3.2,"count":7922}}}
getNumber&service=telegram&country=krAcheter un 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ètres de la requête

NomObligatoireDescription
api_keyTousClé API créée depuis l'écran du compte
actionTousgetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberCode du service (ex. : telegram, whatsapp, google). Identique à l'adresse de la page dans la liste des services
countrygetNumberkr (numéro coréen 010, kr par défaut)
idgetStatus, setStatusID du numéro renvoyé par getNumber (commence par N-)
statussetStatus8 annuler, 3 un autre code, 6 terminer, 1 prêt

Textes 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 arrivéPaiement effectué
STATUS_WAIT_RETRY:CODEEn attente du code suivant (avec les codes précédents)Sans frais supplémentaires
STATUS_CANCELAnnulé ou temps écouléRemboursé en l'absence de code
ACCESS_CANCELAnnuléRemboursement total
ACCESS_RETRY_GETAttendre un autre code sur le même numéroSans frais supplémentaires
ACCESS_ACTIVATIONJ'ai fini d'utiliser le numéroInchangé
NO_BALANCERechargez votre solde et recevez aussitôtNon débité
NO_NUMBERSAucun numéro de ce pays disponible pour l'instantNon débité
NO_ACTIVATIONSVous avez 20 numéros ouvertsNon débité
EARLY_CANCEL_DENIEDNuméro avec code : terminer (6) au lieu d'annulerInchangé
BAD_KEYClé API invalideNon débité
BAD_SERVICE / BAD_COUNTRYCode de service ou de pays invalideNon débité
NO_ACTIVATIONID de numéro introuvableInchangé
TOO_MANY_REQUESTSLimite de 300 requêtes par minute dépasséeNon débité

Exemples par langage

import time, requests

BASE = "https://010sms.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="kr")
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 un numéro avec getNumber, saisissez-le dans le formulaire d'inscription, puis appelez getStatus toutes les 5 secondes.
  • STATUS_OK : quand le code arrive, saisissez-le puis terminez avec setStatus 6.
  • Si le code n'arrive pas en 20 minutes, le prix du numéro est remboursé automatiquement sur votre solde.
  • Jusqu'à 300 requêtes par minute.
API de vérification SMS | 010SMS