Documentation API

Integrez WhatsApp, SMS et Email en quelques minutes

API REST v4 simples, documentees et prets pour la production. Auth JWT, webhooks, envoi en masse et bien plus encore.

  • Authentification JWT Bearer securisee
  • Webhooks en temps reel pour tous les evenements
  • Sandbox gratuit, aucune carte de credit requise
  • Documentation OpenAPI 3.0 complete
Demarrage rapide

Integrez en 3 etapes

De zero a des messages envoyes en moins de 10 minutes.

1

Obtenez votre token

Appelez l'endpoint d'authentification avec vos identifiants pour obtenir un token JWT a utiliser dans toutes les requetes suivantes.

POST /api/v4/auth/token
{"username":"...","password":"..."}
→ {"token": "eyJh..."}
2

Envoyez votre premier message

Utilisez le token dans l'en-tete Authorization et appelez l'endpoint pour envoyer un message WhatsApp, SMS ou Email.

POST /whatsapp/chats/{id}/message
Authorization: Bearer <token>
→ {"status": "sent"}
3

Recevez des evenements

Configurez un webhook pour recevoir les messages entrants, confirmations de livraison et mises a jour de statut en temps reel.

POST /api/v4/webhooks/create
"url": "https://your-app.com/hook"
→ {"status": "active"}
Securite

Authentification JWT Bearer

Toutes les API Chat API utilisent des tokens JWT. Generez votre token avec un seul appel POST et incluez-le dans l'en-tete Authorization de chaque requete.

Expiration configurable

Les tokens expirent apres une periode configurable. Regenerez automatiquement via API sans interruption.

HTTPS requis

Toutes les communications s'effectuent via HTTPS avec TLS 1.2+. Aucun appel en clair accepte.

Identifiants securises

Le nom d'utilisateur et le mot de passe ne sont echanges qu'une fois pour obtenir le token utilise dans les appels API.

POST /api/v4/auth/token
{
  "username": "your@email.com",
  "password": "your-password"
}
200 OK Response
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6Ikp...",
  "expiresIn": 3600,
  "type": "Bearer"
}
Utilisez le token dans chaque requete
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6Ikp...
Endpoints

Tous les endpoints disponibles

Chaque endpoint est documente avec les parametres, reponses et exemples dans notre documentation OpenAPI.

WhatsApp
POST

Envoyer un message

/api/v4/whatsapp/chats/{id}/message

Envoyer un message WhatsApp direct

GET

Lister les modeles

/api/v4/notifications/whatsapp/templates

Consulter les modeles WhatsApp approuves

POST

Notification par modele

/api/v4/whatsapp/notifications

Envoyer une notification individuelle hors fenetre de 24h

POST

Envoi en masse

/api/v4/whatsapp/bulk

Envoyer a des milliers de contacts en un seul lot

SMS
POST

Envoyer un SMS

/api/v4/sms/send

Envoyer un SMS a n'importe quel numero dans le monde

POST

Campagne SMS

/api/v4/sms/bulk

Envoi en masse vers des listes de contacts

GET

Rapport de livraison

/api/v4/sms/reports/{id}

Verifier le statut de livraison

Email
POST

Envoyer un email

/api/v4/email/send

Email transactionnel avec DKIM/SPF

POST

Campagne email

/api/v4/email/bulk

Envoyer des campagnes marketing en masse

GET

Evenements email

/api/v4/email/events

Taux d'ouverture, clics, rebonds, desabonnements

Systeme
POST

Authentification

/api/v4/auth/token

Generer un token JWT Bearer

POST

Webhooks

/api/v4/webhooks/create

Configurer la reception d'evenements en temps reel

POST

Widget de chat

/api/v4/iframes/whatsapp/chat-box

Generer un iframe pour le chat WhatsApp

Exemples de code

Integrez dans votre langage

Exemples prets a l'emploi pour vous authentifier et envoyer votre premier message.

cURL
curl -X POST \
  https://app.roxpay.eu/api/v4/auth/token \
  -H "Content-Type: application/json" \
  -d '{"username":"...","password":"..."}'

# Use the token:
curl -X POST \
  .../whatsapp/chats/123/message \
  -H "Authorization: Bearer <token>" \
  -d '{"body":"Hello!"}'
Python
import requests

# Authentication
r = requests.post(
  "https://app.roxpay.eu/api/v4/auth/token",
  json={"username":"...", "password":"..."}
)
token = r.json()["token"]

# Send message
requests.post(
  "...whatsapp/chats/123/message",
  headers={"Authorization": f"Bearer {token}"},
  json={"body": "Hello!"}
)
Node.js
// Authentication
const r = await fetch(
  "https://app.roxpay.eu/api/v4/auth/token",
  { method: "POST",
    headers: {"Content-Type":"application/json"},
    body: JSON.stringify({username,password}) }
);
const { token } = await r.json();

// Send message
await fetch("...chats/123/message", {
  method: "POST",
  headers: { Authorization: `Bearer ${token}` },
  body: JSON.stringify({ body: "Hello!" })
});
Environnements

Sandbox et production

Testez librement dans l'environnement sandbox sans frais, puis passez en production avec un simple changement d'URL. Zero refactorisation.

Sandbox gratuit

Aucun credit consomme. Messages simules. Tests illimites sans configuration supplementaire.

Production evolutive

Infrastructure enterprise avec SLA 99,9 % et support technique dedie.

Basculement instantane

Changez uniquement l'URL de base pour passer du sandbox a la production. Meme code, meme contrat API.

Sandbox

URL de base

https://sandbox.roxpay.eu

✓ Messages simules  ·  ✓ Gratuit  ·  ✓ Donnees de test

Production

URL de base

https://app.roxpay.eu

✓ Messages reels  ·  ✓ SLA 99,9 %  ·  ✓ Support dedie

OpenAPI 3.0 - Swagger UI

Documentation complete disponible

Tous les parametres, schemas de reponse, codes d'erreur et exemples interactifs dans l'interface Swagger.