smscartesim

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

Send an SMS or WhatsApp message using your virtual numbers or approved Sender IDs.

Paramètres

Paramètre Type Obligatoire Description
from_sender string Oui Your virtual number or approved Sender ID.
to_number string Oui The recipient phone number (with country code).
message string Oui The message content.
type string Non The channel to use: 'sms' or 'whatsapp'.
POST

/otp/send

Generate and send a 6-digit OTP code to a phone number.

Paramètres

Paramètre Type Obligatoire Description
phone string Oui The recipient phone number.
provider string Non Specific provider to use (infobip, twilio, etc).
POST

/otp/verify

Verify a previously sent OTP code.

Paramètres

Paramètre Type Obligatoire Description
phone string Oui The phone number the code was sent to.
code string Oui The 6-digit OTP code.