88API88API
User GuideAI ApplicationsAPI ReferenceHelp & Support
API Module Guide

Module de gestion des jetons

Description des fonctionnalités

Le préfixe de l'API est https://88api.ai

Gérez les jetons API de votre compte : création, mise à jour, suppression et opérations par lots, avec restrictions de modèle, restrictions IP, quota et date d'expiration configurables.

🔐 Authentification de l'utilisateur

Obtenez tous les jetons

  • Nom de l'interface: Obtenez tous les jetons
  • Méthode HTTP: GET
  • Chemin: /api/token/
  • Exigence d'authentification: Utilisateur
  • Description de la fonction: Pagine et récupère la liste de tous les jetons appartenant à l'utilisateur actuel.

💡 Exemple de demande:

const response = await fetch('/api/token/?p=1&size=20', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Exemple de réponse réussie:

{
  "success": true,
  "message": "",
  "data": {
    "items": [
      {
        "id": 1,
        "name": "API Token",
        "key": "`<YOUR_API_KEY>`",
        "status": 1,
        "remain_quota": 1000000,
        "unlimited_quota": false,
        "expired_time": 1640995200,
        "created_time": 1640908800,
        "accessed_time": 1640995000
      }
    ],
    "total": 5,
    "page": 1,
    "page_size": 20
  }
}

❗ Exemple de réponse échouée:

{
  "success": false,
  "message": "Failed to retrieve Token list"
}

🧾 Description du champ:

  • p (Numéro): Numéro de page, la valeur par défaut est 1
  • size (Nombre): Nombre d'éléments par page, la valeur par défaut est 20
  • items (Array): liste d'informations sur les jetons
  • total (Nombre): Nombre total de jetons
  • page (Numéro): Numéro de la page actuelle
  • page_size (Nombre): Nombre d'éléments par page

Jeton de recherche

  • Nom de l'interface: jeton de recherche
  • Méthode HTTP: GET
  • Chemin: /api/token/search
  • Exigence d'authentification: Utilisateur
  • Description de la fonction: recherche les jetons de l'utilisateur en fonction de mots-clés et de valeurs de jetons.

💡 Exemple de demande:

const response = await fetch('/api/token/search?keyword=api&token=sk-123', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Exemple de réponse réussie:

{
  "success": true,
  "message": "",
  "data": [
    {
      "id": 1,
      "name": "API Token",
      "key": "sk-your-token-placeholder",
      "status": 1,
      "remain_quota": 1000000
    }
  ]
}

❗ Exemple de réponse échouée:

{
  "success": false,
  "message": "Failed to search Token"
}

🧾 Description du champ:

  • keyword (Chaîne) : mot-clé de recherche, correspond au nom du jeton
  • token (String): recherche de valeur de jeton, prend en charge la correspondance partielle

Obtenez un jeton unique

  • Nom de l'interface: obtenez un jeton unique
  • Méthode HTTP: GET
  • Chemin: /api/token/:id
  • Exigence d'authentification: Utilisateur
  • Description de la fonction: récupère des informations détaillées sur le jeton spécifié.

💡 Exemple de demande:

const response = await fetch('/api/token/123', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Exemple de réponse réussie:

{
  "success": true,
  "message": "",
  "data": {
    "id": 123,
    "name": "API Token",
    "key": "sk-your-token-placeholder",
    "status": 1,
    "remain_quota": 1000000,
    "unlimited_quota": false,
    "model_limits_enabled": true,
    "model_limits": "gpt-5.5,claude-sonnet-5-5",
    "allow_ips": "192.168.1.1,10.0.0.1",
    "group": "default",
    "expired_time": 1640995200,
    "created_time": 1640908800,
    "accessed_time": 1640995000
  }
}

❗ Exemple de réponse échouée:

{
  "success": false,
  "message": "Token does not exist"
}

🧾 Description du champ:

id (Numéro): ID de jeton, transmis via le chemin URL

Créer un jeton

  • Nom de l'interface: Créer un jeton
  • Méthode HTTP: POST
  • Chemin: /api/token/
  • Exigence d'authentification: Utilisateur
  • Description de la fonction: crée un nouveau jeton API, prend en charge la création par lots.

💡 Exemple de demande:

const response = await fetch('/api/token/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  },
  body: JSON.stringify({
    name: "My API Token",
    expired_time: 1640995200,
    remain_quota: 1000000,
    unlimited_quota: false,
    model_limits_enabled: true,
    model_limits: ["gpt-5.5", "claude-sonnet-5-5"],
    allow_ips: "192.168.1.1,10.0.0.1",
    group: "default"
  })
});
const data = await response.json();

✅ Exemple de réponse réussie:

{
  "success": true,
  "message": ""
}

❗ Exemple de réponse échouée:

{
  "success": false,
  "message": "Token name is too long"
}

🧾 Description du champ:

  • name (String) : Nom du jeton, longueur maximale 30 caractères
  • expired_time (Nombre): horodatage d'expiration, -1 signifie n'expire jamais
  • remain_quota (Nombre) : Quota restant
  • unlimited_quota (Booléen) : indique si le quota est illimité
  • model_limits_enabled (Booléen): s'il faut activer les limites du modèle
  • model_limits (Array) : Liste des modèles autorisés
  • allow_ips (Chaîne) : adresses IP autorisées, séparées par des virgules
  • group (String) : Groupe d'appartenance

Mettre à jour le jeton

  • Nom de l'interface: jeton de mise à jour
  • Méthode HTTP: PUT
  • Chemin: /api/token/
  • Exigence d'authentification: Utilisateur
  • Description de la fonction: met à jour la configuration du jeton, prend en charge le basculement d'état et les mises à jour complètes.

💡 Exemple de demande (mise à jour complète):

const response = await fetch('/api/token/', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  },
  body: JSON.stringify({
    id: 123,
    name: "Updated Token",
    expired_time: 1640995200,
    remain_quota: 2000000,
    unlimited_quota: false,
    model_limits_enabled: true,
    model_limits: ["gpt-5.5", "claude-sonnet-5-5"],
    allow_ips: "192.168.1.1",
    group: "vip"
  })
});
const data = await response.json();

💡 Exemple de demande (mise à jour du statut uniquement):

const response = await fetch('/api/token/?status_only=true', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  },
  body: JSON.stringify({
    id: 123,
    status: 1
  })
});
const data = await response.json();

✅ Exemple de réponse réussie:

{
  "success": true,
  "message": "",
  "data": {
    "id": 123,
    "name": "Updated Token",
    "status": 1
  }
}

❗ Exemple de réponse échouée:

{
  "success": false,
  "message": "The token has expired and cannot be enabled. Please modify the token expiration time first, or set it to never expire"
}

🧾 Description du champ:

  • id (Numéro): ID du jeton, obligatoire
  • status_only (Paramètre de requête) : s'il faut mettre à jour uniquement l'état
  • Les autres champs sont les mêmes que ceux de l'interface Créer un jeton, tous sont facultatifs

Supprimer le jeton

  • Nom de l'interface: Supprimer le jeton
  • Méthode HTTP: SUPPRIMER
  • Chemin: /api/token/:id
  • Exigence d'authentification: Utilisateur
  • Description de la fonction: supprime le jeton spécifié.

💡 Exemple de demande:

const response = await fetch('/api/token/123', {
  method: 'DELETE',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Exemple de réponse réussie:

{
  "success": true,
  "message": ""
}

❗ Exemple de réponse échouée:

{
  "success": false,
  "message": "Token does not exist"
}

🧾 Description du champ:

id (Numéro): ID de jeton, transmis via le chemin URL

Jeton de suppression par lots

  • Nom de l'interface: Jeton de suppression par lots
  • Méthode HTTP: POST
  • Chemin: /api/token/batch
  • Exigence d'authentification: Utilisateur
  • Description de la fonction: supprime plusieurs jetons dans un lot.

💡 Exemple de demande:

const response = await fetch('/api/token/batch', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  },
  body: JSON.stringify({
    ids: [1, 2, 3, 4, 5]
  })
});
const data = await response.json();

✅ Exemple de réponse réussie:

{
  "success": true,
  "message": "",
  "data": 5
}

❗ Exemple de réponse échouée:

{
  "success": false,
  "message": "Parameter error"
}

🧾 Description du champ:

  • ids (Array): Liste des ID de jeton à supprimer, obligatoire et ne peut pas être vide
  • data (Nombre): Nombre de jetons supprimés avec succès