Documentation API

Intégrez nos services de communication directement dans vos applications.

Bien démarrer

Points de terminaison

Introduction

L’API smscartesim vous permet d’accéder à nos services de manière programmatique, notamment l’achat de numéros temporaires, la consultation du solde et la récupération des SMS. Notre API suit les principes REST et renvoie des réponses JSON.

Authentification

Authentifiez vos requêtes en incluant votre clé API dans les en-têtes de requête.

Authorization: Bearer YOUR_API_KEY

Vous pouvez générer et gérer vos clés API depuis votre Tableau de bord utilisateur.

URL de base

Toutes les requêtes API doivent être envoyées à :

https://smscartesim.com/api/v1
GET

/user/balance

Récupérez le solde actuel de votre compte.

Exemple de réponse

{
  "status": "success",
  "balance": 50.00,
  "currency": "USD"
}
GET

/services

Obtenez la liste des services et pays disponibles pour les numéros temporaires.

Paramètres

Paramètre Type Description
country string Optionnel. Filtrer par code pays (ex. 'us', 'uk').
POST

/orders

Acheter un nouveau numéro temporaire.

Paramètres

Paramètre Type Obligatoire Description
service string Oui Code service (ex. 'wa' pour WhatsApp).
country string Oui Identifiant ou code pays.
GET

/sms

Récupérez les SMS de vos numéros. Si aucun ID n’est fourni, renvoie la liste des numéros actifs.

Paramètres

Paramètre Type Obligatoire Description
id string Non L’identifiant du numéro/de la commande pour lequel vérifier les SMS.
POST

/messages

Envoyez un SMS ou un message WhatsApp à l'aide de vos numéros virtuels ou identifiants d'expéditeur approuvés.

Paramètres

Paramètre Type Obligatoire Description
from_sender string Oui Votre numéro virtuel ou identifiant d'expéditeur approuvé.
to_number string Oui Le numéro de téléphone du destinataire, avec l'indicatif du pays.
message string Oui Le contenu du message.
type string Non Le canal à utiliser : 'sms' ou 'whatsapp'.
POST

/otp/send

Générez et envoyez un code OTP à 6 chiffres à un numéro de téléphone.

Paramètres

Paramètre Type Obligatoire Description
phone string Oui Le numéro de téléphone du destinataire.
provider string Non Fournisseur spécifique à utiliser (Infobip, Twilio, etc.).
POST

/otp/verify

Vérifiez un code OTP précédemment envoyé.

Paramètres

Paramètre Type Obligatoire Description
phone string Oui Le numéro de téléphone auquel le code a été envoyé.
code string Oui Le code OTP à 6 chiffres.