Canaux

Lister les canaux d’envoi

GET/v1/channels

Les secrets des canaux (jetons de bot, URL et secrets de webhook) ne sont jamais renvoyés ; target est masqué.

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

Liste paginée par curseur : voir Pagination.

Paramètres de requête#

limitinteger
Par défaut 50
de 1 à 100
cursorstring
next_cursor de la page précédente, tel quel.

Réponses#

200Une page de canaux.

Champs de l’objet

datatableau de objectobligatoire
Champs de chaque élément
- idstring · uuid
- kindstring
  Valeurs webhook discord slack email telegram hellome
- namestringpeut valoir null
- statestring
  Valeurs active disabled
- rolestring
  Valeurs alerts escalation
- targetstringpeut valoir null
  Destination masquée, par exemple https://hooks.example.com/aicscan, a***@example.com.
- created_atstring · date-time
- disabled_atstring · date-timepeut valoir null
- disabled_reasonstringpeut valoir null
- last_success_atstring · date-timepeut valoir null
- linked_atstring · date-timepeut valoir null
has_morebooleanobligatoire
next_cursorstringobligatoirepeut valoir null

4xx · 5xxErreur.

Erreur au format standard : voir Erreurs.

Requête

cURL

curl "https://aicscan.io/v1/channels?limit=20" \
  -H "Authorization: Bearer $AICSCAN_API_KEY"

JavaScript

const res = await fetch('https://aicscan.io/v1/channels?limit=20', {
  headers: {
    Authorization: `Bearer ${process.env.AICSCAN_API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

Python

import os
import requests

resp = requests.get(
    "https://aicscan.io/v1/channels?limit=20",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

Réponse 200

JSON

{
  "data": [
    {
      "id": "0193a1b3-7d21-7c55-8e0a-9f1b2c3d4e5f",
      "kind": "webhook",
      "name": "SIEM",
      "state": "active",
      "role": "alerts",
      "target": "https://hooks.example.com/aicscan",
      "created_at": "2026-11-14T09:12:40.118Z",
      "disabled_at": null,
      "disabled_reason": null,
      "last_success_at": "2026-11-14T09:30:14.020Z",
      "linked_at": null
    }
  ],
  "has_more": true,
  "next_cursor": "0193a1b25c3d7e4f8a9b0c1d2e3f4a5b"
}