Guide d'utilisation de l'API

Ce guide décrit les flux courants avec l'API v2. Pour la référence complète des endpoints, consultez la Référence API.

Prérequis

Une clé API ChinqIT Verify (X-API-Key)
URL de base : https://sms.chinqit.com/api/v2

Démarrage rapide

Envoyer un SMS — POST /api/v2/notify
Envoyer un OTP — POST /api/v2/code
Vérifier un OTP — POST /api/v2/check
Suivre la livraison — GET /api/v2/notify/
Diffusions — POST /api/v2/bulk/send et GET /api/v2/bulk/status/

Chaque endpoint est documenté avec exemples curl, paramètres et réponses dans la Référence API.

OTP et SMS Retriever (Android)

Pour l'auto-remplissage OTP sur Android, incluez le paramètre hash dans POST /api/v2/code. Voir le Guide SMS Retriever.

Format des numéros et erreurs

Les numéros mauritaniens doivent respecter les formats décrits dans la Référence API. En cas de problème, consultez le Dépannage.

Expéditeur (nom alphanumérique)

Les messages sortants sont envoyés sous un expéditeur alphanumérique — le nom que les destinataires voient à la place d'un numéro de téléphone. Un expéditeur ne contient que des lettres et des chiffres (sans espaces ni caractères spéciaux), par exemple MyCompany, Store123 ou Bank2024. Pour utiliser un expéditeur personnalisé, faites-en la demande depuis le tableau de bord (Admin → Demandes d'expéditeur) ; des frais mensuels peuvent s'appliquer. Tant qu'aucun expéditeur n'est actif, les messages utilisent l'expéditeur par défaut CHINQIT.

API v1 (dépréciée) : documentation archivée dans API v1 (dépréciée).