Développeurs

API revendeurs

Intégrez les numéros VeriNum à votre site, votre bot Telegram ou votre boutique. Mêmes prix, mêmes remises fidélité et même remboursement automatique que sur le site.

Clé personnelle

Créée dans Espace › API revendeurs, stockée chiffrée chez nous.

60 req./min

Par clé. Au-delà : code HTTP 429 et en-tête Retry-After.

Remboursement auto

Aucun SMS : votre solde est recrédité, sans action de votre part.

Authentification

Envoyez votre clé dans l’en-tête Authorization. Toutes les réponses sont en JSON : { ok, data } ou { ok: false, error, message }.

curl https://validesms.com/api/v1/balance \
  -H "Authorization: Bearer vn_live_VOTRE_CLE"

Points d’accès

GET/api/v1/balance

Solde du compte

Réponse

{ "ok": true, "data": { "balance": 12500, "currency": "XOF" } }

GET/api/v1/services

Services, pays, prix (remise fidélité incluse), taux de réussite mesuré et stock. Filtre facultatif : ?service=google

Réponse

{ "ok": true, "data": [ { "service": "google", "name": "Google / Gmail",
  "countries": [ { "country": "US", "name": "États-Unis", "price": 450, "success_rate": 0.91, "stock": 320 } ] } ] }

POST/api/v1/buy

Achète un numéro. Le montant est réservé puis remboursé automatiquement si aucun SMS n’arrive. guaranteed (vrai par défaut) active l’attribution automatique d’un nouveau numéro si aucun SMS n’arrive.

Corps JSON

{ "service": "google", "country": "US", "guaranteed": true }

Réponse

{ "ok": true, "data": { "id": "cm…", "status": "WAITING", "phone": "+12025550143", "price": 450, "attempts": 1, "maxAttempts": 3 } }

GET/api/v1/status/{id}

État de la commande. Interrogez toutes les 3 à 5 secondes jusqu’à RECEIVED, REFUNDED ou CANCELLED. Le numéro peut changer si un nouveau numéro est attribué.

Réponse

{ "ok": true, "data": { "id": "cm…", "status": "RECEIVED", "code": "482913", "smsText": "…", "events": [ … ] } }

POST/api/v1/cancel/{id}

Annule une commande en attente et rembourse immédiatement le solde.

Réponse

{ "ok": true, "data": { "id": "cm…", "status": "CANCELLED", "refunded": 450 } }

Codes d’erreur

401	invalid_api_key	Clé absente, invalide ou révoquée
402	error	Solde insuffisant
404	error	Commande introuvable
429	rate_limited	Trop de requêtes
503	error	Aucun numéro disponible (non débité)

Créer ma clé API Statut du service