API

API d'activation par SMS

Achetez des numéros et lisez les codes depuis vos propres scripts. L'API utilise le format commun d'activation par SMS, donc la plupart des clients existants fonctionnent en changeant l'adresse de base et la clé.

Créez votre clé API sur la page des clés API de la console. Elle n'est affichée qu'une seule fois.

Obtenir la clé API Inscription

Adresse de base et clé

Envoyez des requêtes GET ou POST à l'adresse de base avec api_key et action. Créez la clé sur la page Clé API de la console ; elle est affichée une seule fois.

https://snsactivate.com/stubs/handler_api.php?api_key=YOUR_KEY&action=getBalance

Les codes de service sont les noms sur nos pages de service (par exemple whatsapp, telegram, google). Les codes de pays sont des codes ISO en minuscules (us, gb, in). Limite : 300 requêtes par minute par clé. Chaque activation a une fenêtre de 20 minutes, comme dans la console.

getBalance

Votre crédit en USD.

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getBalance

ACCESS_BALANCE:12.50

getServicesList

Codes de service que vous pouvez acheter (JSON).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getServicesList

{"status":"success","services":[{"code":"whatsapp","name":"WhatsApp"}]}

getCountries

Codes de pays (ISO, minuscules) et codes d'appel (JSON).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getCountries

{"us":{"name":"United States","dial":"1"}}

getPrices

Prix en USD et quantités en stock par pays et service. Les deux filtres sont facultatifs.

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getPrices&service=whatsapp&country=us

{"us":{"whatsapp":{"cost":0.18,"count":130598}}}

getNumber

Achète une activation. Retourne l'identifiant de l'activation et le numéro avec son code de pays.

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getNumber&service=whatsapp&country=us

ACCESS_NUMBER:AC-7K2M9QX4PB:13475550182

getStatus

STATUS_WAIT_CODE (pas encore de code), STATUS_OK:<code>, STATUS_WAIT_RETRY:<dernier code> (un autre code demandé), STATUS_CANCEL (annulé ou remboursé).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getStatus&id=AC-7K2M9QX4PB

STATUS_OK:482913

setStatus

status=1 prêt (ACCESS_READY), 3 un autre code (ACCESS_RETRY_GET), 6 terminer (ACCESS_ACTIVATION), 8 annuler avec remboursement intégral tant qu'aucun code n'est arrivé (ACCESS_CANCEL).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=setStatus&id=AC-7K2M9QX4PB&status=3

ACCESS_RETRY_GET

Flux typique

getNumber avec le service et le pays. Sauvegardez l'identifiant.
Entrez le numéro dans l'application et demandez le SMS.
Appelez getStatus toutes les 5 à 10 secondes jusqu'à STATUS_OK.
Besoin d'un autre SMS ? setStatus 3, puis getStatus à nouveau. Terminé : setStatus 6.
Pas de code ? setStatus 8 annule avec un remboursement intégral. Sans appel, le remboursement se fait automatiquement à la fin de la fenêtre.

Erreurs

BAD_KEY	Clé API manquante ou incorrecte.
BAD_ACTION	Action inconnue.
BAD_SERVICE	Code de service inconnu.
BAD_COUNTRY	Le service n'est pas vendu dans ce pays.
NO_BALANCE	Crédit insuffisant.
NO_NUMBERS	Aucun numéro disponible pour le moment. Réessayez dans un instant.
NO_ACTIVATION	Identifiant d'activation inconnu ou ne vous appartenant pas.
EARLY_CANCEL_DENIED	Un code est déjà arrivé, donc l'activation ne peut pas être annulée.
TOO_MANY_REQUESTS	Plus de 300 requêtes en une minute.
NO_ACTIVATIONS	20 activations sont déjà ouvertes.