Intégrez facilement nos services SMS dans vos applications avec nos endpoints REST.
POST
Envoi d'un SMS simple
https://api.smscongo.cd/SendSMS
Envoyez un SMS à un ou plusieurs destinataires en une seule requête.
Paramètres obligatoires
| Paramètre | Type | Description |
|---|
| ApiKey | string | Clé API fournie par SMSCongo |
| ClientId | string | Identifiant client |
| SenderId | string | Nom de l'expéditeur (personnalisé) |
| Message | string | Texte du message (160 caractères max par SMS) |
| MobileNumbers | string | Numéros séparés par des virgules (ex: 2439xxxx,2439yyyy) |
Paramètres optionnels
| Paramètre | Type | Description |
|---|
| Is_Unicode | boolean | Pour les caractères spéciaux (true/false) |
| Is_Flash | boolean | Message flash apparaissant à l'écran (true/false) |
| DataCoding | integer | 0: GSM 7 bits, 3: ISO-8859-1, 8: UCS-2 |
| ScheduleTime | string | Programmation (format yyyy-MM-dd HH:mm) |
| GroupId | integer | ID d'un groupe de contacts pré-enregistré |
Exemple de requête (cURL)
curl -X POST "https://api.smscongo.cd/SendSMS?ApiKey=VOTRE_API_KEY&ClientId=VOTRE_CLIENT_ID&SenderId=MON_ENTREPRISE&Message=Bonjour%20client&MobileNumbers=2439xxxxxx" \
-H "Content-Type: application/json" \
-H "Type: json"
Exemple de réponse (succès)
{
"success": true,
"response": {
"Status": "OK",
"MessageId": "123456789",
"CreditsUsed": 1
}
}
Réponse d'erreur :
{
"success": false,
"error": "Invalid ApiKey"
}
POST
Envoi de SMS en masse (Bulk)
https://api.smscongo.cd/SendBulkSMS
Envoyez des messages personnalisés à plusieurs destinataires en une seule requête.
Paramètres obligatoires (dans le corps JSON)
| Paramètre | Type | Description |
|---|
| ApiKey | string | Clé API |
| ClientId | string | Identifiant client |
| SenderId | string | Nom de l'expéditeur |
| MessageParameters | array | Tableau d'objets contenant 'Number' et 'Text' pour chaque destinataire |
Paramètres optionnels (dans le corps JSON)
| Paramètre | Type | Description |
|---|
| Is_Unicode | boolean | true/false |
| Is_Flash | boolean | true/false |
| DataCoding | integer | 0, 3 ou 8 |
| SchedTime | string | yyyy-MM-dd HH:mm |
Exemple de requête (JSON)
{
"ApiKey": "VOTRE_API_KEY",
"ClientId": "VOTRE_CLIENT_ID",
"SenderId": "MON_ENTREPRISE",
"MessageParameters": [
{ "Number": "2439xxxxxx1", "Text": "Message personnalisé 1" },
{ "Number": "2439xxxxxx2", "Text": "Message personnalisé 2" }
],
"Is_Unicode": false,
"Is_Flash": false
}
Commande cURL correspondante
curl -X POST https://api.smscongo.cd/SendBulkSMS \
-H "Content-Type: application/json" \
-H "Type: json" \
-d '{
"ApiKey": "VOTRE_API_KEY",
"ClientId": "VOTRE_CLIENT_ID",
"SenderId": "MON_ENTREPRISE",
"MessageParameters": [
{"Number": "2439xxxxxx1", "Text": "Message 1"},
{"Number": "2439xxxxxx2", "Text": "Message 2"}
]
}'
Exemple de réponse (succès)
{
"success": true,
"http_code": 200,
"response": {
"Status": "OK",
"BulkId": "987654321",
"TotalMessages": 2
}
}
Réponse d'erreur :
{
"success": false,
"error": "Invalid MessageParameters format"
}