Documentation API

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

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

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

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

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é
            }
        }
}
                                                
                                            

Paramètres $api_key - Votre clé API

Réponse
JSON - objet au format

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

                                        

Paramètres $api_key - Votre clé API

Réponse
JSON - objet au format

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

                                        

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

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

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

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

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

"pays": {
    "service": {
            "prix1": quantité,
            "prix2": quantité,
            "prix3": quantité,
          }
     },
            

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

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

"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,
          },
          }
     },
            

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

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

    {
        "wallet_address": "TFGMAwTfxtxKvy1mTTHr7XJaXeumjdmhGg"
    }

Un Webhook est un mécanisme permettant de notifier automatiquement un système à propos d'événements. Après l'acquisition d'un numéro, il n'est pas nécessaire d'interroger constamment le serveur pour vérifier si des SMS sont arrivés. Nous pouvons immédiatement envoyer leur contenu à l'adresse (ou aux multiples adresses) que vous spécifiez dans les paramètres.

Adresses IP pour les requêtes Webhook

Pour assurer le bon fonctionnement des notifications et éviter leur perte, ajoutez les adresses IP suivantes à la liste blanche des sources autorisées sur votre serveur :

Les webhooks pour les activations et les locations proviendront des adresses suivantes :

Assurez-vous que votre serveur accepte les requêtes entrantes provenant de ces adresses IP.

Notifications SMS entrantes

Si l'URL du Webhook https://your-site.com/webhook.php est spécifiée dans votre profil, nous ferons une requête POST à cette adresse dans le format suivant lorsqu'un SMS sera reçu :

{
    "activationId": 123456,
    "service": "go",
    "text": "Sms text",
    "code": "12345",
    "country": 2,
    "receivedAt": "2023-01-01 12:00:00"
}

Réponse du serveur

Votre script doit renvoyer un statut HTTP de 200.

• - Si le serveur ne répond pas, 2 nouvelles tentatives seront faites après 1 minute puis après 5 minutes.
• - En cas de 3 tentatives infructueuses, vous recevrez une notification et verrez des erreurs dans votre profile.

Vous pouvez activer ou désactiver les Webhooks dans vos profile settings.