Aide de SMSverifica · rubrique 11 sur 18
11. L'API REST : tout ce que fait le panneau, depuis votre logiciel
Tout ce que fait le panneau peut se faire par API
(https://app.smsverifica.com/api/v1) :
POST /messages— envoyer un SMS, un WhatsApp ou un Telegram.GET /messages/{id}etGET /messages— statut et historique.POST /campaigns— campagnes complètes.POST /verify/startetPOST /verify/check— vérification OTP prête à l'emploi : nous générons le code, nous l'envoyons et nous le vérifions.POST /certified— messagerie certifiée.GET /account/balanceetGET /pricing/sms— solde et tarifs en vigueur.GET /sendersetGET /senders/check— vos expéditeurs et ce qui se passerait aujourd'hui en envoyant avec eux vers l'Espagne : s'ils partent avec votre marque, avec l'expéditeur de secours ou s'ils sont refusés (Registre des alias de la CNMC).
Authentification recommandée : jeton Bearer créé sur cet écran (affiché une
seule fois ; révocable ; avec expiration facultative). Toute requête de
création accepte Idempotency-Key, ainsi une nouvelle tentative due au réseau
ne duplique jamais un envoi. Sans solde, l'API répond
402 insufficient_balance — votre intégration peut réagir en rechargeant ou en
alertant.
La référence complète avec des exemples curl se trouve sur
smsverifica.com/api-sms.html.
Webhooks de statut
Au lieu d'interroger l'API chaque minute, donnez-nous une de vos URL et c'est nous qui vous notifions chaque changement de statut (envoyé, remis, échoué, lu…), avec une signature pour que vous vérifiiez que c'est bien nous, et des tentatives automatiques si votre serveur ne répond pas.