Canaux

Envoyer un message de test

POST/v1/channels/{id}/test

Met un message de test en file ; suivez son envoi sur la notification indiquée par Location. 409 channel_inactive sur un canal désactivé.

Authentification: Clé d’API (Authorization: Bearer)
Portée requise: write

Rejouable sans risque avec l’en-tête Idempotency-Key : voir Idempotence.

Paramètres de chemin#

idstring · uuidobligatoire

En-têtes#

Idempotency-Keystring
Permet de relancer le POST sans risque pendant 24 heures.

de 1 à 255 caractères

Réponses#

202Message de test mis en file.

En-têtes de réponse

Locationstring
/v1/notifications/{id}

Champs de l’objet

channel_idstring · uuid
notification_idstring · uuid
statusstring
Valeurs queued

4xx · 5xxErreur.

Erreur au format standard : voir Erreurs.

Requête

cURL

curl -X POST "https://aicscan.io/v1/channels/0193a1b3-7d21-7c55-8e0a-9f1b2c3d4e5f/test" \
  -H "Authorization: Bearer $AICSCAN_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

JavaScript

const res = await fetch('https://aicscan.io/v1/channels/0193a1b3-7d21-7c55-8e0a-9f1b2c3d4e5f/test', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.AICSCAN_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

Python

import os, uuid
import requests

resp = requests.post(
    "https://aicscan.io/v1/channels/0193a1b3-7d21-7c55-8e0a-9f1b2c3d4e5f/test",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

Réponse 202

JSON

{
  "channel_id": "0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d",
  "notification_id": "0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d",
  "status": "queued"
}