Aller au contenu
Lisoloo

Journal des modifications

Changements côté API. Le format suit Keep a Changelog.

Non publié

Section intitulée « Non publié »

Prévu

Section intitulée « Prévu »
  • Signature HMAC des webhooks (X-Lisoloo-Signature, X-Lisoloo-Timestamp, HMAC-SHA256 du corps). Non implémenté actuellement ; les webhooks sont authentifiés via HTTP Basic seulement. Voir Présentation des webhooks pour la posture actuelle.
  • Fenêtre d’annulation pour les envois instantanés. Un drapeau cancel_within: 30s sur POST /send pour vous permettre d’interrompre un envoi instantané fraîchement mis en file avant le handoff opérateur.
  • Spec OpenAPI 3.1 publiée à /openapi.yaml (ce site de docs sert déjà une version écrite à la main).
  • SMS entrants — messagerie bidirectionnelle pour les campagnes par mot-clé. Nécessitera un enregistrement séparé d’endpoint entrant dans le portail.

[v1.0.0] — actuel

Section intitulée « [v1.0.0] — actuel »

La surface publique actuelle. Quatre endpoints à travers la référence API : POST /send, GET /status/{message_id}, GET /balance, GET /health, plus les endpoints de gestion DELETE /cancel/{id}, POST /pause/{id}, POST /resume/{id} pour les envois planifiés et récurrents.

Fonctionnalités

Section intitulée « Fonctionnalités »
  • Authentification app-key. En-tête unique, par marchand, par environnement.
  • Deux environnements : sandbox et production. L’URL de base de chacun est affichée sur la page Bloonio dev portal → Lisoloo → Developer → Clés API.
  • Trois types d’envoi : instantané, planifié, récurrent.
  • Accusés de livraison par webhook à chaque transition d’état, avec auth HTTP Basic et backoff exponentiel sur 4 tentatives.
  • Limites de débit par clé API : 60/min sur POST /send, 120/min sur GET /status, 30/min sur GET /balance, illimité sur GET /health.
  • Catalogue d’erreurs stable : valeurs error_code 1001–1599. Voir Erreurs.

Surface stable

Section intitulée « Surface stable »

Ces contrats sont garantis dans v1 :

  • Tous les chemins et méthodes d’endpoints listés dans la référence API.
  • Le catalogue error_code — les codes ne changent jamais de sens.
  • Les types de champs dans les corps de requête et de réponse.
  • Les types d’événements webhook (sms.queued, sms.processing, sms.sent, sms.delivered, sms.failed) et la forme de l’enveloppe.

Les changements cassants seront publiés sous /api/v2/lisoloo/sms-api/ ; la surface v1 sera dépréciée avec un préavis minimum de 6 mois.

Voir aussi

Section intitulée « Voir aussi »