Changements et versions
Contrat SMS documenté : 2.0.2
Cette documentation décrit le contrat SMS relu et identifié ci-dessus. La disponibilité instantanée du service est distincte de sa version.
SMS v2.0.2 · Reprises après effacement de données personnelles
Section intitulée « SMS v2.0.2 · Reprises après effacement de données personnelles »Le contrat SMS v2.0.2 précise la réponse 410 personal_data_erased lors du rejeu de POST /api/sms/v2/messages/ après l’effacement ciblé des données personnelles d’un message dont le traitement est terminé. La même clé et le même contenu ne déclenchent aucun nouvel envoi ni mouvement de crédits. Conservez la clé et arrêtez les reprises de cette opération ; ne renvoyez pas le message avec une nouvelle clé.
Un contenu différent avec la même clé reste un conflit 409 idempotency_conflict. Le catalogue des erreurs et le guide d’idempotence présentent la réponse exacte et la conduite à tenir.
30 septembre 2026 · SMS v2.0.1 et portail développeur disponibles
Section intitulée « 30 septembre 2026 · SMS v2.0.1 et portail développeur disponibles »SMS v2.0.1 est disponible pour les organisations disposant d’une installation SMS active. Le contrat couvre l’envoi immédiat, la programmation, les lots, les crédits, les contacts et le suivi de livraison. Les clés organisationnelles et les permissions de chaque opération restent requises.
La version 2.0.1 harmonise les réponses d’indisponibilité temporaire de SMS v2. Le code service_unavailable et les règles de reprise avec la même clé d’idempotence sont détaillés dans le catalogue des erreurs.
Le portail Befiana for Developers ouvre avec :
- Des guides complets en français et en anglais pour préparer l’accès, envoyer, programmer et suivre les messages.
- Un premier SMS guidé et des recettes Node.js/Python pour les reprises et la pagination.
- Une référence API issue du contrat SMS v2.0.1, avec descriptions traduites et exemples JSON identiques dans les deux langues.
- Une collection Postman SMS v2.0.1 publiée avec les sept opérations, des variables privées à renseigner et des clés d’idempotence conservées lors des reprises.
Les intégrations v1 restent disponibles pendant la migration. Aucune date de retrait n’est annoncée.
La référence v2 couvre les clés organisationnelles Bearer, les messages identifiés par UUID, l’idempotence requise, la programmation RFC 3339 et les lots consultables. La v1 reste accessible pendant la migration.
La version exacte du contrat figure dans le document OpenAPI anglais. La documentation est publiée avec le contrat de la release backend correspondante.
Compatibilité
Section intitulée « Compatibilité »Une correction conserve le contrat public. Une évolution compatible peut ajouter une capacité sans invalider les usages existants. Une rupture nécessite un nouveau namespace majeur. Les changements d’interface Cloud et les changements d’API produit ont des versions distinctes.
Consultez également les notes publiques dans l’espace développeur de BEFIANA Cloud.
Disponibilité du service
Section intitulée « Disponibilité du service »La version du contrat décrit les requêtes et les réponses prises en charge. Elle ne renseigne pas l’état instantané de l’API ni la livraison d’un message. Aucune page de disponibilité en temps réel n’est annoncée dans ce portail pour le moment.
Pour un incident d’intégration, préparez une demande d’assistance. Pour un SMS particulier, consultez ses rapports de livraison.
Dépréciation de v1
Section intitulée « Dépréciation de v1 »Le début de migration est lié à la disponibilité générale de v2, après validation de la couverture fonctionnelle. Aucune date de retrait de v1 n’est fixée ici. Une annonce ultérieure précisera les usages concernés, le calendrier et l’accompagnement disponible.
Suivez le guide de migration pour préparer votre application. Les engagements propres à votre contrat restent à confirmer avec BEFIANA.