Environnements

Lisoloo dispose de deux environnements — sandbox et production. Ils sont distincts par configuration, pas par préfixe d’URL : les mêmes chemins existent à chaque URL de base.

Environnement	Source de BASE_URL	Préfixe de clé	Objectif
Sandbox	URL sandbox sur le tableau de bord Bloonio dev portal	sk_test_*	Trafic de test en libre-service. Les SMS sont routés vers un opérateur factice ; aucune livraison réelle, aucun coût réel.
Production	URL production sur le tableau de bord Bloonio dev portal	sk_live_*	SMS en direct. Opérateurs réels. Coût réel sur votre solde.

Où trouver votre BASE_URL

Après vous être connecté au tableau de bord Bloonio, ouvrez Lisoloo → Developer → Clés API. Chaque bloc d’environnement affiche son URL de base à côté de la carte de la clé. Copiez cette valeur telle quelle dans votre variable d’environnement BASE_URL ; chaque exemple sur ce site suppose que l’URL est chargée ainsi.

Nous n’imprimons délibérément pas les URLs dans ces docs — elles peuvent changer par région ou par déploiement, et votre tableau de bord affiche toujours la valeur correcte pour votre compte.

Chaque endpoint Lisoloo est monté sous /api/v1/lisoloo/sms-api/. La sonde /health non authentifiée est disponible dans les deux environnements.

Choisir un environnement

Il n’y a pas de bascule globale « environnement » — le choix de l’URL de base et le préfixe de la clé déterminent ensemble l’environnement. Une clé sandbox (sk_test_*) ne peut pas s’authentifier contre l’URL de production, et vice-versa — ce qui renvoie 401.

# Erreur — clé sandbox contre URL de production
curl $BASE_URL/api/v1/lisoloo/sms-api/balance \
  -H "app-key: sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# → 401 avec "Missing or invalid app-key"

Configuration par environnement

Les deux environnements sont indépendants : clés API séparées, configuration webhook séparée, solde séparé, buckets de limite de débit séparés. Faire tourner une clé sandbox n’affecte pas la production, et vice-versa.

# Sandbox  (collez le BASE_URL sandbox depuis votre tableau de bord)
export BASE_URL=<url-base-sandbox-depuis-tableau-de-bord>
export LISOLOO_API_KEY=sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
export LISOLOO_API_URL=$BASE_URL/api/v1/lisoloo/sms-api

# Production  (collez le BASE_URL production depuis votre tableau de bord)
export BASE_URL=<url-base-production-depuis-tableau-de-bord>
export LISOLOO_API_KEY=sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
export LISOLOO_API_URL=$BASE_URL/api/v1/lisoloo/sms-api

Particularités du sandbox à connaître

• Pas de livraison réelle. Les SMS sandbox sont acceptés et parcourent l’intégralité du cycle de vie (pending → processing → sent → delivered) mais aucun trafic opérateur n’est généré. Le destinataire ne reçoit rien.
• Numéros de destinataire de test. Utilisez n’importe quel numéro E.164 bien formé — le sandbox ne valide pas contre une base de numéros réelle. Nous recommandons +243998857000 pour la parité avec la documentation.
• Les webhooks se déclenchent normalement. Les appels callback_url et les POSTs webhook_url du sandbox sont de vraies requêtes HTTP depuis la passerelle. Utilisez un service comme webhook.site pour les inspecter.
• Aucun coût réel. total_cost dans la réponse est calculé mais jamais débité du solde. Le champ available_sms dans GET /balance rapporte le quota sandbox, pas les crédits production.
• Les limites de débit sont identiques. N’ajustez pas votre harnais de test sur des limites spécifiques au sandbox — elles correspondent à la production.

Vérifiez l'URL de base avant d'envoyer du trafic réel

Le sandbox accepte n’importe quel numéro au format E.164 y compris des numéros réels. L’opérateur est factice, donc passer votre propre numéro réel en sandbox ne fera pas arriver le message — mais en production l’opérateur le fera. Confirmez quel BASE_URL vous avez exporté avant de lancer un vrai envoi.

Voir aussi

• Authentification — format de l’en-tête
• Clés API — où le tableau de bord affiche votre BASE_URL
• Votre premier SMS — visite sandbox