API

API REST pour commander des numéros virtuels, interroger les SMS, gérer les locations et recharger le portefeuille. Les mêmes endpoints que ceux du tableau de bord — authentification par bearer token, JSON in/out, aucun SDK requis.

Authentification

Générez un token API personnel depuis Tableau de bord → Tokens API. Incluez-le en tant que header bearer sur chaque requête :

Authorization: Bearer <your-token>

URL de base

https://smsactivator.io

Endpoints

  • GET/v1/servicesLister les services supportés avec les tarifs actuels par pays.
  • GET/v1/countriesLister les pays avec un inventaire actif.
  • POST/v1/ordersCommander un numéro virtuel. Body : { serviceSlug, countryIso }. Retourne le numéro alloué et l'orderId.
  • GET/v1/orders/:idInterroger le statut de réception des SMS. Retourne { status, sms, expiresAt }.
  • DELETE/v1/orders/:idAnnuler une commande active. Rembourse le portefeuille si aucun SMS reçu.
  • POST/v1/paymentsCréer une facture de dépôt crypto. Body : { provider, amountUsd, cryptoCurrency? }. Retourne le payLink d'OxaPay.
  • GET/v1/walletObtenir le solde du portefeuille actuel et les transactions récentes.
  • GET/v1/rentalsLister les locations long terme actives.

Démarrage rapide

curl -X POST https://smsactivator.io/v1/orders \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"serviceSlug":"telegram","countryIso":"US"}'

Limites de débit

  • Placement de commandes : 30 requêtes / minute / token
  • Interrogation de commandes : 120 requêtes / minute / token
  • Paiements / dépôts : 10 requêtes / heure / token
  • Limite globale par IP : 120 requêtes / minute (s'applique même sans token)

Dépasser une limite retourne HTTP 429 avec un header Retry-After.

Besoin d'une limite plus élevée ?

Contactez-nous @smsactivator_support avec votre cas d'usage. Les offres revendeur et intégration bénéficient d'un budget de burst 10x sur les endpoints de commande.