Tout ce qu'il faut savoir pour intégrer FastNotify dans votre application, expliqué simplement.
FastNotify est une plateforme SMS professionnelle qui permet aux développeurs d'intégrer l'envoi de messages texte dans leurs applications grâce à une API REST simple et sécurisée.
Ce guide explique, sans code complexe, comment fonctionne l'API FastNotify et les étapes à suivre pour l'intégrer dans n'importe quelle application.
Ce guide est destiné aux développeurs web, mobile ou backend qui souhaitent ajouter des fonctionnalités SMS dans leurs applications existantes.
Envoyez des messages texte personnalisés à vos clients avec leur nom et informations.
Générez et envoyez des codes de vérification à usage unique pour sécuriser vos utilisateurs.
Envoyez des alertes de commande, livraison ou paiement automatiquement.
Envoyez des milliers de SMS personnalisés en une seule requête.
L'API FastNotify fonctionne selon le modèle REST. Imaginez l'API comme un guichet de service : votre application fait une demande, le guichet traite la demande et vous donne une réponse.
| Étape | Votre application fait... | FastNotify répond... |
|---|---|---|
| 1 | Envoie une requête HTTP POST vers l'URL de l'API | Reçoit la requête et vérifie votre identité |
| 2 | Fournit votre clé API dans l'en-tête | Vérifie votre clé et votre solde SMS |
| 3 | Envoie les données (numéro, message) | Transmet le SMS via le réseau téléphonique |
| 4 | Attend la réponse JSON | Retourne le résultat avec le statut d'envoi |
Pour utiliser l'API FastNotify, vous devez vous identifier avec une clé API unique. Cette clé joue le rôle de mot de passe pour accéder à l'API.
Connectez-vous sur FastNotify → Cliquez sur "🔑 Ma clé API" dans le menu → Copiez votre clé.
Cette clé doit être incluse dans chaque requête dans l'en-tête (header) :
// En-tête à inclure dans chaque requête
Authorization: Bearer VOTRE_CLE_API
Content-Type: application/json
Ne partagez jamais votre clé API publiquement (GitHub, forum, etc.). Si votre clé est compromise, régénérez-en une nouvelle depuis votre dashboard FastNotify.
Un endpoint est l'adresse URL à laquelle vous envoyez vos requêtes. Chaque fonctionnalité de FastNotify a son propre endpoint.
| Endpoint | Méthode | Description |
|---|---|---|
| /api/sendsms.php | POST | Envoyer un SMS simple à un numéro |
| /api/sendotp.php | POST | Générer et envoyer un code OTP |
| /api/settings.php | POST | Envoyer une notification prédéfinie |
| /api/template.php | POST | Envoyer un SMS via un modèle |
| /api/sendbulksms.php | POST | Envoyer des SMS en masse |
Tous les endpoints commencent par : https://fastnotify.online
Exemple complet : https://fastnotify.online/api/sendsms.php
Voici les étapes à suivre pour intégrer FastNotify dans votre application, du début à la fin.
Rendez-vous sur la page d'accueil, choisissez un plan adapté à votre volume d'envoi, inscrivez-vous et effectuez le paiement via MTN MoMo ou Orange Money.
Connectez-vous à votre dashboard → Cliquez sur "🔑 Ma clé API" → Copiez et conservez votre clé dans un endroit sécurisé.
Depuis votre dashboard, cliquez sur "📖 Documentation API", identifiez l'endpoint dont vous avez besoin et consultez les paramètres requis.
Dans votre application, configurez l'URL de base, votre clé API et l'endpoint ciblé. Stockez la clé API dans une variable d'environnement, jamais directement dans le code.
Envoyez une requête HTTP POST avec l'en-tête d'authentification et les données JSON (numéro, message). Vérifiez la réponse pour confirmer le succès.
Vérifiez le champ success dans la réponse JSON. Si true → SMS envoyé. Si false → vérifiez le champ error.
// Exemple de réponse en cas de succès
{
"success": true,
"message_id": "SM9x8a7b6c5d4e3f2a1b",
"sms_restants": 487
}
// Exemple de réponse en cas d'erreur
{
"success": false,
"error": "Solde SMS insuffisant"
}
Voici les scénarios les plus courants d'intégration de FastNotify dans une application.
Le client valide sa commande → votre application récupère son numéro → appelle FastNotify → le client reçoit un SMS de confirmation instantanément.
L'utilisateur entre son numéro → votre app appelle /api/sendotp.php → FastNotify génère et envoie le code → l'utilisateur entre le code pour valider.
Préparez votre liste de clients avec leur numéro → rédigez votre message avec variables {nom} → appelez /api/sendbulksms.php → FastNotify personnalise et envoie chaque SMS.
Créez vos modèles dans FastNotify → notez leur ID → appelez /api/template.php avec l'ID et le numéro → le message prédéfini est envoyé automatiquement.
Lorsqu'une requête échoue, FastNotify retourne un code HTTP accompagné d'un message explicatif.
| Code HTTP | Signification | Que faire ? |
|---|---|---|
| 200 | ✅ Succès | Le SMS a été envoyé avec succès. |
| 400 | Requête invalide | Vérifiez que tous les paramètres requis sont présents et correctement formatés. |
| 401 | Non autorisé | Votre clé API est manquante ou incorrecte. Vérifiez-la dans votre dashboard. |
| 403 | Solde insuffisant | Votre solde SMS est épuisé. Rechargez votre compte depuis la page Facturation. |
| 404 | Endpoint introuvable | L'URL de l'endpoint est incorrecte. Vérifiez la documentation API. |
| 500 | Erreur serveur | Problème côté serveur. Réessayez dans quelques minutes ou contactez le support. |
✅ Correct : +237612345678 ❌ Incorrect : 612345678 00237612345678 +237 612 345 678
Si vous rencontrez des difficultés lors de l'intégration de l'API FastNotify, voici les ressources disponibles :