Statut d’un SMS

Endpoint léger pour connaître l’état d’envoi après un POST /sms/send — même authentification HMAC que le reste de l’API publique.

Getting started → Authentification

sms-status.sh

                        # Vérifier l’auth (ping)
curl -sS "$BASE/api/v1/public/util/ping" \
  -H "X-API-KEY: …" \
  -H "X-TIMESTAMP: …" \
  -H "X-SIGNATURE: …"
                    

✓ GET …/status

Endpoint

`GET /api/v1/public/sms/{id}/status`

Remplacez {id} par l’identifiant numérique retourné à la création du SMS. La réponse est volontairement compacte pour un polling raisonnable ; le détail complet du message est disponible sur GET /api/v1/public/sms/{id}.

Exemple

Requête et réponse

cURL

curl -sS -X GET "https://api.novixo.fr/api/v1/public/sms/123/status" \
  -H "X-API-KEY: $NOVIXO_API_KEY" \
  -H "X-TIMESTAMP: $TIMESTAMP" \
  -H "X-SIGNATURE: $SIGNATURE"

Chaîne signée (exemple) : GET|/api/v1/public/sms/123/status|${TIMESTAMP}|

Réponse JSON (illustratif)

{
  "id": 123,
  "status": "DELIVERED",
  "recipient": "+33601020304",
  "sentAt": "2025-11-15T10:00:05.000Z",
  "deliveredAt": "2025-11-15T10:00:12.000Z",
  "creditsUsed": "1"
}

Les champs exacts suivent le contrat exposé dans la documentation client ; utilisez de préférence les webhooks pour limiter le polling en production.

Documentation

Aller plus loin

Listes filtrées, réponses entrants et journaux : tout est décrit dans la référence API de l’espace client.

Accéder à l’espace client → Getting started