Documentation API - SMSBower
API

Documentation API

L'API est le protocole qui permet la communication entre votre logiciel et notre serveur d'activation .

L'API est nécessaire pour automatiser la réception des SMS, OTP et PVA de votre côté.

Notre API est entièrement compatible avec les sites concurrents.
Toutes les requêtes doivent être envoyées à https://smsbower.online/stubs/handler_api.php
via POST ou GET.

Toutes les requêtes doivent contenir une clé API en paramètre 'api_key'

Obtenir le solde
https://smsbower.online /stubs/handler_api.php?api_key=$api_key&action=getBalance
Copié

Paramètres $api_key - Votre clé API

Réponse
ACCESS_BALANCE:solde du compte

Erreurs possibles
BAD_KEY - clé API invalide

Réponse
ACCESS_BALANCE:$yourBalance

Obtenir un numéro de téléphone
https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getN
umber&service=$service&country=$country&maxPrice=$maxPrice
&providerIds=$providerIds&exceptProviderIds$exceptProviderIds
&phoneException$phoneException&ref$ref
Copié

Paramètres $api_key - Votre clé API $service - service voir tableau voir tableau $country - numéro du pays voir tableau $maxPrice - prix maximum pour lequel vous êtes prêt à acheter un numéro $providerIds - Liste des fournisseurs pour achats, séparés par des virgules (1,2,3) $exceptProviderIds - Liste des fournisseurs exclus des achats, séparés par des virgules (1,2,3) $phoneException - excluant les préfixes pour les numéros. Séparés par des virgules. Format d'enregistrement : indicatif pays et 3 à 6 chiffres du masque (ex. 7918,7900111) $ref - transférer l'ID de parrainage En obtenant un numéro via l'API, vous acceptez les règles du projet

Réponse ACCESS_NUMBER:$activationId:$phoneNumber

Erreurs possibles BAD_KEY - clé API invalide BAD_ACTION - action incorrecte BAD_SERVICE - nom de service incorrect

Obtenir le code SMS
https://smsbower.online /stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id
Copié

Paramètres $api_key - Votre clé API $id - id activation

Réponse
STATUS_WAIT_CODE - En attente du SMS STATUS_WAIT_RETRY:$lastCode - En attente du prochain SMS STATUS_CANCEL - Activation annulée STATUS_OK: 'activation code' - code reçu

Erreurs possibles
BAD_KEY - clé API invalide BAD_ACTION - action incorrecte NO_ACTIVATION - id d'activation incorrect

Changement du statut d'activation
https://smsbower.online /stubs/handler_api.php?api_key=$api_key&action=setSt
atus&status=$status&id=$id
Copié
Paramètres $api_key - Votre clé API $id - id activation $status - statut de l'activation
1 - informer de la disponibilité du numéro (SMS envoyé au numéro) 3 - demander un autre code (gratuit) 6 - compléter l'activation * 8 - informer que le numéro a été utilisé et annuler l'activation

Logique simple de la chronologie de l'API:

Obtenir un numéro avec la méthode getNumber, après quoi les actions suivantes sont disponibles: 8 - Annuler l'activation (si le numéro ne vous convient pas) 1 - Signaler que le SMS a été envoyé (optionnel)

Pour une activation avec le statut 1: 8 - Annuler l'activation

Immédiatement après réception du code: 3 - Demander un autre SMS 6 - Confirmer le code SMS et compléter l'activation

Pour une activation avec le statut 3: 6 - Confirmer le code SMS et compléter l'activation

Réponse ACCESS_READY - le numéro est prêt à recevoir des SMS ACCESS_RETRY_GET - en attente d'un nouveau SMS ACCESS_ACTIVATION - le service a été activé avec succès ACCESS_CANCEL - activation annulée

Erreurs possibles
NO_ACTIVATION - id d'activation incorrect BAD_STATUS - statut incorrect BAD_KEY - clé API invalide BAD_ACTION - action incorrecte EARLY_CANCEL_DENIED - Il est possible d'annuler le numéro après 2 minutes suivant l'achat

Obtenir les prix actuels
https://smsbower.online /stubs/handler_api.php?api_key=$api_key&action=getP
rices&service=$service&country=$country
Copié

Paramètres $api_key - Votre clé API $service - nom du service (optionnel, par défaut tous les services) voir tableau voir tableau $country - nom du code (optionnel, par défaut tous les pays) voir tableau

Réponse
JSON - objet au format

{''Pays'':
        {''Service'':
            {
                ''cost'':Coût,'
                'count'':Quantité
            }
        }
}
                                                
                                            

Liste des services
https://smsbower.online /stubs/handler_api.php?api_key=$api_key&action=getServicesList
Copié

Paramètres $api_key - Votre clé API

Réponse
JSON - objet au format


    {
        "status": "success",
        "services": [
            {
                "code": "kt",
                "name": "KakaoTalk"
            }
        ]
    }

                                        

Liste des pays
https://smsbower.online /stubs/handler_api.php?api_key=$api_key&action=getCountries
Copié

Paramètres $api_key - Votre clé API

Réponse
JSON - objet au format


    {
        {
            "id": 1003
            "rus": "Бермуды"
            "eng": "Bermuda"
            "chn": "百慕大"
        }
    }

                                        

Obtenir un numéro de téléphoneV2

Cette méthode fonctionne comme getNumber, prend les mêmes paramètres, mais retourne des informations d'activation supplémentaires .

https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getN
umberV2&service=$service&country=$country&maxPrice=$maxPrice
&providerIds=$providerIds&exceptProviderIds=$exceptProviderIds
Copié

Paramètres api_key - Votre clé API $service - service voir tableau voir tableau $country - numéro du pays voir tableau $maxPrice - prix maximum pour lequel vous êtes prêt à acheter un numéro $providerIds - Liste des fournisseurs pour achats, séparés par des virgules (1,2,3) $exceptProviderIds - Liste des fournisseurs exclus des achats, séparés par des virgules (1,2,3) En obtenant un numéro via l'API, vous acceptez les règles du projet

Réponse

Si la requête réussit, la réponse sera au format suivant .

{
               "activationId": "id",
               "phoneNumber": number,
               "activationCost": activationCost,
               "countryCode": countryCode,
               "canGetAnotherSms": canGetAnotherSms,
               "activationTime": activationTime,
               "activationOperator": activationOperator,
}
Copié

Erreurs possibles BAD_KEY - clé API invalide BAD_ACTION - action incorrecte BAD_SERVICE - nom de service incorrect

Obtenir la liste complète des prix v2
https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getP
ricesV2&service=$service&country=$country
Copié

Paramètres api_key - Votre clé API $service - service voir tableau $country - numéro du pays voir tableau

Exemple de réponse
"pays": {
    "service": {
            "prix1": quantité,
            "prix2": quantité,
            "prix3": quantité,
          }
     },
            
Copié

Erreurs possibles BAD_KEY - clé API invalide BAD_ACTION - action incorrecte BAD_SERVICE - nom de service incorrect

Obtenir la liste complète des prix v3
https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getP
ricesV3&service=$service&country=$country
Copié

Paramètres api_key - Votre clé API $service - service voir tableau $country - numéro du pays voir tableau

Exemple de réponse
"pays": {
    "service": {
            "provider 1 id": {
                count: quantité,
                price: prix,
                provider_id: provider id,
          },
            "provider 2 id": {
                count: quantité,
                price: prix,
                provider_id: provider id,
          },
          "provider 3 id": {
                count: quantité,
                price: prix,
                provider_id: provider id,
          },
          }
     },
            
Copié

Erreurs possibles BAD_KEY - clé API invalide BAD_ACTION - action incorrecte BAD_SERVICE - nom de service incorrect BAD_COUNTRY - nom de pays incorrect

Get static wallet
https://smsbower.online/api/payment/getActualWalletAddress?api_key=$api_key&coin=$coin
&network=$network
Copié

Paramètres api_key - Votre clé API $coin - coin (usdt, trx) $network - network number (tron)

Exemple de réponse
    {
        "wallet_address": "TFGMAwTfxtxKvy1mTTHr7XJaXeumjdmhGg"
    }
Copié
Example Postman