Canaux

État d’une invitation Telegram ou helloMe

GET/v1/channel-invites/{token}

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

Paramètres de chemin#

tokenstringobligatoire
au plus 128 caractères

Réponses#

200Invitation.

Champs de l’objet

tokenstring
localestring
Valeurs fr en
statusstring
Valeurs pending linked expired
linkedboolean
channel_idstring · uuidpeut valoir null
Renseigné une fois le canal relié. Reste renseigné même si le canal est supprimé ensuite (il répond alors 404 sur /v1/channels/{id}).
created_atstring · date-time
expires_atstring · date-time
used_atstring · date-timepeut valoir null

4xx · 5xxErreur.

Erreur au format standard : voir Erreurs.

Requête

cURL

curl "https://aicscan.io/v1/channel-invites/Kx3p9QvT2mWb7aZr" \
  -H "Authorization: Bearer $AICSCAN_API_KEY"

JavaScript

const res = await fetch('https://aicscan.io/v1/channel-invites/Kx3p9QvT2mWb7aZr', {
  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/channel-invites/Kx3p9QvT2mWb7aZr",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

Réponse 200

JSON

{
  "token": "Kx3p9QvT2mWb7aZr",
  "locale": "fr",
  "status": "linked",
  "linked": true,
  "channel_id": "0193a1b3-7d21-7c55-8e0a-9f1b2c3d4e5f",
  "created_at": "2026-11-14T09:15:00Z",
  "expires_at": "2026-11-14T09:25:00Z",
  "used_at": "2026-11-14T09:17:41Z"
}