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.