SDK & exemples de code

Lisoloo n’expédie pas de SDK first-party. La surface API est assez petite — quatre endpoints — pour qu’un wrapper léger autour du client HTTP standard de votre langage soit le pattern d’intégration recommandé.

Les exemples de code ci-dessous couvrent les quatre langages que nous testons et distribuons via le portail développeur Bloonio :

Python requests / httpx — patterns sync et async.

JavaScript / Node.js fetch (Node 18+) et axios.

PHP exemples cURL + Guzzle.

cURL Le plus petit dénominateur commun. Vit dans le démarrage rapide.

Ce qu’un client Lisoloo wrappe

Une surface de client raisonnable pour n’importe quel langage :

LisolooClient(api_key, base_url=PRODUCTION)
  .send(to, message, sender_id=None, callback_url=None,
        sending_type="immediate",
        scheduled_dates=None, recurring_schedule=None) -> SendResponse
  .get_status(message_id)                              -> StatusResponse
  .get_balance()                                       -> BalanceResponse
  .cancel(message_id)                                  -> None
  .pause(message_id)                                   -> None
  .resume(message_id)                                  -> None

Les quatre endpoints canoniques tiennent sur un écran ; les endpoints de gestion (cancel, pause, resume) ne sont nécessaires que pour les envois planifiés / récurrents.

Dépendances recommandées

Langage	Bibliothèque	Pourquoi
Python	httpx (ou requests si vous êtes sur legacy)	Sync + async, même surface
JavaScript / Node	fetch natif (Node ≥ 18)	Pas de dépendance ; API identique au fetch navigateur
PHP	Extension cURL (ou guzzlehttp/guzzle pour du code plus propre)	Les libs standard couvrent tous les besoins
Go	net/http	La bibliothèque standard suffit
Java / Kotlin	java.net.http.HttpClient (Java 11+) ou okhttp	Support natif depuis Java 11

Pas encore de SDK first-party

Lokotroo expédie des SDK Flutter et Angular parce que les flux de paiement ont des préoccupations UI (challenges 3DS, saisie OTP). Le SMS n’en a pas — chaque appel est un seul aller-retour avec une enveloppe JSON. Nous documentons des clients faits-maison plutôt que maintenir des SDKs qui seraient des wrappers fins.

Conventions communes

Chaque extrait sur ce site suppose :

export LISOLOO_API_KEY=sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
export LISOLOO_API_URL=$BASE_URL/api/v1/lisoloo/sms-api

Pour le sandbox, basculez vers sk_test_* et $BASE_URL/....

L’ensemble complet d’exemples est mirroré sur les pages par-langage — Python, JavaScript, PHP.