Passer au contenu
Français
  • Il n'y a aucune suggestion car le champ de recherche est vide.

Comment intégrer l’API REST de smsmode ?

L’API REST de smsmode est une interface moderne, robuste et sécurisée, conçue pour les développeurs. Elle vous permet d’interconnecter facilement vos applications métiers, sites e-commerce, ou systèmes d'information (CRM, ERP) avec notre infrastructure de routage pour automatiser toutes vos communications mobiles.

Basée sur les standards de l'architecture RESTful, elle utilise les requêtes HTTP classiques (GET, POST, DELETE, PATCH) et communique avec le format de données standard JSON.

🚀 Fonctionnalités principales couvertes par l'API

L'API REST ne se limite pas à l'envoi de messages, elle vous donne le contrôle total sur votre compte smsmode depuis votre propre code :

  • Routage multicanal : Envoi de messages transactionnels ou de campagnes marketing via SMS, messages vocaux (TTS), RCS (Rich Communication Services) et sessions Time2Chat.

  • Envois unitaires ou en masse (Bulk) : Gestion de l'envoi immédiat ou planification (envoi différé) selon vos besoins.

  • Personnalisation et SenderID : Configuration dynamique du nom d'émetteur (SenderID alphanumérique) pour que vos clients identifient votre marque.

  • Webhooks et bidirectionnalité : Réception en temps réel des accusés de réception (DLR) et des réponses de vos destinataires (MO) directement sur vos serveurs via nos URL de notification (Callbacks).

  • Gestion des contacts : Création, mise à jour, suppression et segmentation de vos carnets d’adresses et listes de diffusion.

  • Monitoring : Récupération automatique de vos statistiques de campagnes, taux de délivrabilité, et consultation de votre solde de crédits.


🔐 Authentification et Sécurité

Pour garantir la sécurité de vos données et de vos envois, l’accès à notre API REST est strictement protégé par une Clé API (API Key).

  1. Générer la clé : Connectez-vous à votre espace client smsmode web, rendez-vous dans les paramètres développeur et générez une nouvelle clé API.

  2. Authentifier vos requêtes : Cette clé doit être transmise dans l'en-tête HTTP (Header) de chacune de vos requêtes (généralement via le paramètre X-Api-Key ou Authorization).

🛑 Bonne pratique de cybersécurité :
Considérez votre clé API comme un mot de passe critique. Ne la partagez jamais publiquement (ex: sur GitHub) et ne l'intégrez jamais dans le code source côté client (Front-end, application mobile). Vos requêtes API doivent toujours être exécutées depuis votre serveur (Back-end).


📖 Documentation et mise en route (Quickstart)

Pour faciliter votre intégration, nous mettons à votre disposition une documentation interactive (au format Swagger / OpenAPI).

Vous y trouverez la description complète de tous nos endpoints, les paramètres obligatoires et facultatifs, la liste des codes d'erreur, ainsi que des exemples de requêtes prêts à être copiés-collés dans votre langage de programmation favori (cURL, PHP, Python, Node.js, Java, etc.).

👉 Accéder au Portail Développeurs et à la Documentation API REST



🛠️ Support et assistance technique

Vous rencontrez une erreur 400 ou 500 inexpliquée ? Vous avez besoin d'aide pour configurer vos Webhooks ?

Notre équipe de support, basée en France, est à l'écoute des développeurs pour vous accompagner tout au long de votre phase d'intégration technique.

📧 Contactez le support technique : support@smsmode.com