API Publique VioSMS

Intégrez VioSMS dans vos applications pour acheter et vérifier automatiquement des numéros. Tous les endpoints nécessitent une Clé API.

Authentification

Authentifiez vos requêtes en incluant votre clé API dans l'en-tête Authorization.

HTTP Header
Authorization: Bearer YOUR_API_KEY
GET/api/v1/balance

Retourne le solde actuel de votre compte.

Réponse
{
  "status": "success",
  "balance": 15.50,
  "currency": "USD"
}
GET/api/v1/services

Retourne une liste de tous les services disponibles et leurs prix minimums.

Note: Si vous recherchez un service spécifique comme Hinge ou Tinder, utilisez ce point de terminaison pour récupérer dynamiquement tous les codes de service disponibles.

Réponse
{
  "status": "success",
  "data": [
    {
      "code": "wa",
      "name": "WhatsApp",
      "price": 0.25
    }
  ]
}
GET/api/v1/countries

Récupérez une liste de tous les pays disponibles et de leurs codes. Vous devez utiliser le code de cette réponse lors de l'achat d'un numéro.

Réponse
{
  "status": "success",
  "data": [
    {
      "code": "turkey",
      "name": "Turkey"
    },
    {
      "code": "62",
      "name": "Indonesia"
    }
  ]
}
POST/api/v1/buy

Achète un nouveau numéro de téléphone. Le coût sera déduit de votre solde.

ParamètreIntégrez VioSMS dans vos applications pour acheter et vérifier automatiquement des numéros. Tous les endpoints nécessitent une Clé API.
servicestring*

Code du service (ex. "wa" pour WhatsApp).

countrystring*

Code du pays (ex. "161" pour la Turquie).

operatorstring

Code opérateur optionnel. Par défaut "any".

Requête
{
  "service": "wa",
  "country": "161"
}
Réponse
{
  "status": "success",
  "data": {
    "id": "cuid...",
    "phone": "+1234567890",
    "price": 1.25,
    "expiresAt": "2026-06-05T12:00:00.000Z"
  }
}
GET/api/v1/status

Vérifie le statut de vérification SMS d'une activation.

ParamètreIntégrez VioSMS dans vos applications pour acheter et vérifier automatiquement des numéros. Tous les endpoints nécessitent une Clé API.
idstring*

L'ID d'activation unique retourné lors de l'achat.

Réponse
{
  "status": "success",
  "data": {
    "id": "cuid...",
    "status": "SMS_RECEIVED",
    "phone": "+1234567890",
    "smsCode": "456789",
    "smsText": "WhatsApp code: 456789"
  }
}
POST/api/v1/cancel

Annule une activation et rembourse le coût si aucun SMS n'a été reçu.

ParamètreIntégrez VioSMS dans vos applications pour acheter et vérifier automatiquement des numéros. Tous les endpoints nécessitent une Clé API.
idstring*

L'ID d'activation unique à annuler.

Requête
{
  "id": "cuid..."
}
Réponse
{
  "status": "success",
  "message": "Activation cancelled and refunded"
}