Préproduction : l'API répond sur https://api.visiobank.com/v1, avec une clé de test. Les exemples gardent l'adresse de production, api.vizalia.ai, qui ouvrira à la mise en production.

Limites d'envoi

Les plafonds protègent vos clients de SMS en rafale et votre facture d’une boucle qui s’emballe.

Les envois sont plafonnés par clé (150 SMS par heure, 1 500 par jour), par espace (150 par heure) et par destinataire (10 par heure, 20 par jour). Au-delà, l’API répond 429 avec Retry-After. L’entrée de l’API borne aussi le débit de chaque client : au-delà, elle répond 429 avec Retry-After, sans toujours de corps application/problem+json. Traitez ces deux 429 de la même façon.

Sur un 429

Lisez l’en-tête Retry-After : le nombre de secondes à attendre.
Attendez au moins ce délai, puis rejouez la requête avec la même Idempotency-Key (Idempotence).
Ne lisez code que si la réponse est bien du application/problem+json : le 429 de l’entrée de l’API n’en a pas toujours.

Le code de l’erreur est quota_exceeded.

Suivre une session sans webhook

Les réponses ne portent pas d’en-tête de débit (RateLimit). Pour suivre une session, préférez les webhooks ; sans eux, relisez-la à quelques secondes d’intervalle au moins, et traitez un 429 comme ci-dessus.