API de vérification SMS

L'API SNSSIM gère l'achat de numéros, la vérification de codes, l'annulation et la consultation de crédit et prix en une seule requête HTTP. Compatible avec le standard handler_api, il suffit de changer l'adresse et la clé API dans vos programmes existants.

GET /stubs/handler_api.php
  ?api_key=API_KEY&action=getNumber
  &service=telegram&country=gb

ACCESS_NUMBER:SS8Q2K7:447700900123

GET ...&action=getStatus&id=SS8Q2K7
STATUS_OK:48215
Méthode standard de l'industrie
handler_api

Méthode standard de l'industrie

Pour chaque clé API
300 fois par minute

Pour chaque clé API

Pays / Service
145 / 1,255

Pays / Service

Remboursement automatique si aucun code
20 minutes

Remboursement automatique si aucun code

Comment obtenir une clé API ?

Générez votre clé dans le menu API de votre compte après connexion. La clé n'est affichée qu'une fois, sauvegardez-la. L'API utilise le même crédit et prix que l'interface web.

Quelle est l'adresse de base ?

Toutes les requêtes sont envoyées en GET à la même adresse avec api_key et action.

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

Quelles requêtes puis-je envoyer ?

7 types de requêtes sont possibles, de l'achat de numéro à la vérification du code, l'annulation et la consultation du crédit.

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=8Annulation du numéro (remboursement intégral si le code n'est pas reçu)ACCESS_CANCEL
setStatus&id=ID&status=3Recevoir un autre code de vérification 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 nom du service (exemple : telegram, whatsapp, google). Identique aux valeurs de la page de liste des services
countrygetNumberCode pays à 2 lettres (ex: gb, us, id)
idgetStatus, setStatusID du numéro obtenu via getNumber (commençant par N)
statussetStatus8 pour annuler, 3 pour redemander un code, 6 pour terminer, 1 pour prêt

Texte de réponse et signification

Les réponses sont fournies sous forme de texte concis. La déduction de crédit est également indiquée.

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 d'un code de vérification supplémentaire (code précédent inclus)Sans frais supplémentaires
STATUS_CANCELAnnulé ou délai écouléRemboursé en l'absence de code
ACCESS_CANCELAnnuléRemboursement total
ACCESS_RETRY_GETEn attente de réception 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_NUMBERSActuellement, nous ne pouvons pas fournir de numéros pour ce pays.Non débité
NO_ACTIVATIONSVous avez 20 numéros ouvertsNon débité
EARLY_CANCEL_DENIEDPour les numéros ayant reçu un code de vérification, choisissez Terminer (6) et non AnnulerInchangé
BAD_KEYClé API incorrecteNon débité
BAD_SERVICE / BAD_COUNTRYLe code de service ou de pays est incorrectNon débité
NO_ACTIVATIONID de numéro introuvableInchangé
TOO_MANY_REQUESTSLimite de 300 par minute dépasséeNon débité

Quel est l'ordre pour recevoir un code via l'API ?

4 étapes pour recevoir un numéro, l'entrer, vérifier le code et finaliser.

  1. 1 étapes

    Obtenir un numéro

    Utilisez getNumber pour sélectionner service et pays afin d'obtenir un numéro.

    action=getNumber&service=telegram&country=gb
    > ACCESS_NUMBER:SS8Q2K7:447700900123
  2. 2 étapes

    Entrez le numéro

    Entrez le numéro acheté sur la page d'inscription ou dans le programme.

    +44 7700 900123
  3. 3 étapes

    Vérifier le code

    Vérifiez l'arrivée du code en appelant getStatus toutes les 5 secondes.

    action=getStatus&id=SS8Q2K7
    > STATUS_OK:48215
  4. 4 étapes

    Terminer

    Après avoir entré le code, terminez avec setStatus 6. Remboursement automatique si aucun code sous 20 minutes.

    action=setStatus&id=SS8Q2K7&status=6
    > ACCESS_ACTIVATION

Exemples par langage

Voici le processus complet pour recevoir un numéro, attendre le code et finaliser. Cliquez sur l'onglet pour changer la langue.

import time, requests

BASE = "https://snssim.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)

FAQ sur l'API

L'API propose des numéros dans 145 pays et 1,255 services aux mêmes prix que l'interface web.

Qu'est-ce qu'une API de vérification SMS ?
Fonctionnalité pour acheter des numéros, vérifier des codes et annuler via requêtes HTTP. L'API SNSSIM utilise le standard handler_api.
Puis-je utiliser le même programme que sur d'autres sites de vérification SMS ?
Pour les programmes utilisant handler_api, modifiez simplement l'URL de base et la clé API pour vous connecter.
Y a-t-il des frais supplémentaires pour l'API ?
Aucune différence. L'API et l'interface web utilisent les mêmes crédits et prix.
Combien de demandes sont possibles ?
300 requêtes maximum par minute par clé API. Dépassement : erreur TOO_MANY_REQUESTS sans déduction de crédit.
Les numéros achetés via l'API sont-ils remboursables ?
Oui. Si le code n'arrive pas dans les 20 minutes, le numéro acheté via API est automatiquement remboursé en crédit.
Où créer une clé API ?
Générez-la dans le menu API de votre compte après connexion. La clé n'est affichée qu'une fois à la création, sauvegardez-la immédiatement.

Créez une clé API et connectez-vous immédiatement

Après inscription et recharge de crédit, vous pouvez générer une clé API directement depuis votre compte.

API de vérification SMS | SNSSIM