📚 Documentation API REST

Intégrez l'envoi de SMS internationaux dans vos applications en quelques lignes de code

🚀 Démarrage Rapide

L'API HostileGot SMS Pro est une API REST moderne qui vous permet d'envoyer des SMS vers plus de 200 pays à travers le monde. Toutes les requêtes et réponses sont au format JSON.

📌 Note importante : Avant d'utiliser l'API, votre compte doit être activé par notre équipe support. Une fois inscrit, contactez-nous pour demander l'activation de votre accès API.

Base URL

https://hostile-got.com

🔑 Authentification

L'API HostileGot SMS Pro utilise des clés API pour l'authentification. Vous pouvez trouver votre clé API dans votre tableau de bord après vous être connecté.

Méthodes d'authentification

Vous pouvez vous authentifier de deux façons :

Option 1 : Bearer Token (Recommandé)

POST /api_send_sms.php Authorization: Bearer HG-xxxx-xxxx-xxxx Content-Type: application/json

Option 2 : Header personnalisé

POST /api_send_sms.php X-API-KEY: HG-xxxx-xxxx-xxxx Content-Type: application/json
⚠️ Sécurité : Ne partagez jamais votre clé API publiquement. Gardez-la secrète et sécurisée comme un mot de passe.

📤 Envoyer un SMS

POST

Envoyez un SMS vers n'importe quel numéro de téléphone dans le monde.

Endpoint

POST /api_send_sms.php

Paramètres

Paramètre Type Requis Description
api_key string Requis Votre clé API (format: HG-xxxx)
from string Requis Nom de l'expéditeur (max 11 caractères alphanumériques)
to string Requis Numéro de téléphone destinataire avec indicatif pays (ex: +229XXXXXXXX)
message string Requis Contenu du SMS à envoyer

Exemple de requête

cURL

curl -X POST https://hostile-got.com/api_send_sms.php \ -H "Content-Type: application/json" \ -H "Authorization: Bearer HG-xxxx-xxxx-xxxx" \ -d '{ "api_key": "HG-xxxx-xxxx-xxxx", "from": "HostileGot", "to": "+229XXXXXXXX", "message": "Bonjour! Ceci est un message de test." }'

PHP

<?php $ch = curl_init('https://hostile-got.com/api_send_sms.php'); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([ 'api_key' => 'HG-xxxx-xxxx-xxxx', 'from' => 'HostileGot', 'to' => '+229XXXXXXXX', 'message' => 'Bonjour! Ceci est un message de test.' ])); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'Content-Type: application/json', 'Authorization: Bearer HG-xxxx-xxxx-xxxx' ]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); echo $response; ?>

Python

import requests import json url = "https://hostile-got.com/api_send_sms.php" headers = { "Content-Type": "application/json", "Authorization": "Bearer HG-xxxx-xxxx-xxxx" } data = { "api_key": "HG-xxxx-xxxx-xxxx", "from": "HostileGot", "to": "+229XXXXXXXX", "message": "Bonjour! Ceci est un message de test." } response = requests.post(url, headers=headers, json=data) print(response.json())

JavaScript (Node.js)

const axios = require('axios'); const sendSMS = async () => { try { const response = await axios.post( 'https://hostile-got.com/api_send_sms.php', { api_key: 'HG-xxxx-xxxx-xxxx', from: 'HostileGot', to: '+229XXXXXXXX', message: 'Bonjour! Ceci est un message de test.' }, { headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer HG-xxxx-xxxx-xxxx' } } ); console.log(response.data); } catch (error) { console.error('Erreur:', error.response.data); } }; sendSMS();

Réponse en cas de succès

{ "success": true, "message": "SMS envoyé avec succès", "credits_used": 500, "remaining_credits": 9500, "sms_id": 12345 }

Réponse en cas d'erreur

{ "success": false, "error": "Message d'erreur descriptif" }

💰 Consulter le Solde

GET

Vérifiez le solde de crédits disponible sur votre compte.

Endpoint

GET /api_get_balance.php

Exemple de requête

curl -X GET https://hostile-got.com/api_get_balance.php \ -H "Authorization: Bearer HG-xxxx-xxxx-xxxx"

Réponse

{ "success": true, "credits": 10000, "approximate_sms": 20 }

⚠️ Codes d'Erreur

Code HTTP Erreur Description
401 Unauthorized Clé API invalide ou manquante
403 Forbidden API non activée ou compte suspendu
400 Bad Request Paramètres manquants ou invalides
402 Payment Required Crédits insuffisants
500 Internal Server Error Erreur serveur, contactez le support

💡 Bonnes Pratiques

  • 🔐 Sécurité : Ne stockez jamais vos clés API dans le code source. Utilisez des variables d'environnement.
  • ⚡ Rate Limiting : Évitez d'envoyer trop de requêtes simultanées. Limitez à 10 requêtes par seconde maximum.
  • 🔄 Retry Logic : Implémentez une logique de retry avec backoff exponentiel pour gérer les erreurs temporaires.
  • 📊 Monitoring : Surveillez votre solde de crédits régulièrement pour éviter les interruptions de service.
  • ✅ Validation : Validez toujours les numéros de téléphone avant l'envoi pour économiser des crédits.
  • 🌍 Format International : Utilisez toujours le format international avec l'indicatif pays (+XXX).
  • 📝 Logs : Conservez des logs de vos envois pour faciliter le débogage et le suivi.

📧 Envoyer un Email

POST

Envoyez des emails transactionnels et de notification via notre API.

Endpoint

POST /api_send_email.php

Paramètres

Paramètre Type Requis Description
api_key string Requis Votre clé API (format: HG-xxxx)
from_name string Requis Nom de l'expéditeur (ex: Support)
to string Requis Adresse email du destinataire
subject string Requis Sujet de l'email
message string Requis Corps du message (texte ou HTML)

Coût

500 crédits par email envoyé

Exemple de requête

cURL

curl -X POST https://hostile-got.com/api_send_email.php \ -H "Content-Type: application/json" \ -H "Authorization: Bearer HG-xxxx-xxxx-xxxx" \ -d '{ "api_key": "HG-xxxx-xxxx-xxxx", "from_name": "Support", "to": "client@example.com", "subject": "Confirmation de votre commande", "message": "Bonjour,\n\nVotre commande a été confirmée." }'

PHP

<?php $ch = curl_init('https://hostile-got.com/api_send_email.php'); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([ 'api_key' => 'HG-xxxx-xxxx-xxxx', 'from_name' => 'Support', 'to' => 'client@example.com', 'subject' => 'Notification', 'message' => 'Contenu du message' ])); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'Content-Type: application/json', 'Authorization: Bearer HG-xxxx-xxxx-xxxx' ]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); echo $response; ?>

Python

import requests url = "https://hostile-got.com/api_send_email.php" headers = { "Content-Type": "application/json", "Authorization": "Bearer HG-xxxx-xxxx-xxxx" } data = { "api_key": "HG-xxxx-xxxx-xxxx", "from_name": "Support", "to": "client@example.com", "subject": "Notification", "message": "Contenu du message" } response = requests.post(url, headers=headers, json=data) print(response.json())

Réponse d'exemple

{ "success": true, "message": "Email envoyé avec succès", "credits_used": 500, "remaining_credits": 1500 }

Codes d'erreur

Code Description
401 Clé API manquante
403 Clé API invalide ou accès API non activé
400 Champs requis manquants ou invalides
402 Crédits insuffisants

🌍 Pays Supportés

Notre plateforme supporte l'envoi de SMS vers plus de 200 pays à travers le monde, incluant :

🇧🇯 Bénin
🇫🇷 France
🇺🇸 États-Unis
🇨🇦 Canada
🇩🇪 Allemagne
🇬🇧 Royaume-Uni
🇨🇮 Côte d'Ivoire
🇸🇳 Sénégal
🇨🇳 Chine
🇮🇳 Inde
🇧🇷 Brésil
🇦🇺 Australie

... et 190+ autres pays !

Besoin d'aide ?

Notre équipe support est là pour vous aider à intégrer notre API.

🚀 Commencer maintenant

© 2025 HostileGot SMS Pro. Tous droits réservés.