Module utilisateur
Description des fonctionnalités
Le préfixe de l'API est https://88api.ai
Interfaces liées au compte : inscription/connexion, profil personnel, gestion des jetons, recharge/paiement et système d'affiliation. Prend en charge la 2FA, la vérification des e-mails et diverses méthodes de connexion OAuth.
Enregistrement/Connexion au compte
🔐 Aucune authentification requise
Créer un nouveau compte
- Nom de l'interface:Enregistrer un nouveau compte
- Méthode HTTP:POST
- Chemin:
/api/user/register - Exigence d'authentification:Public
- Description de la fonction:Crée un nouveau compte utilisateur, prenant en charge la fonctionnalité de vérification des e-mails et de code de référence
💡 Exemple de demande:
const response = await fetch('/api/user/register', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
username: "newuser",
password: "password123",
email: "user@example.com",
verification_code: "123456",
aff_code: "INVITE123"
})
});
const data = await response.json();✅ Exemple de réponse réussie:
{
"success": true,
"message": "User registration successful"
}❗ Exemple de réponse en cas d'échec:
{
"success": false,
"message": "The administrator has closed new user registration"
}🧾 Description du champ:
username(String) : Nom d'utilisateur, obligatoirepassword(String) : Mot de passe, obligatoireemail(String): adresse e-mail, requise lorsque la vérification de l'e-mail est activéeverification_code(Chaîne): Code de vérification de l'e-mail, requis lorsque la vérification de l'e-mail est activéeaff_code(String) : Code de parrainage, facultatif
Connexion utilisateur
- Nom de l'interface:Connexion utilisateur
- Méthode HTTP:POST
- Chemin:
/api/user/login - Exigence d'authentification:Public
- Description de la fonction:Connexion au compte utilisateur, prenant en charge l'authentification à deux facteurs (2FA)
💡 Exemple de demande:
const response = await fetch('/api/user/login', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
username: "testuser",
password: "password123"
})
});
const data = await response.json();✅ Exemple de réponse réussie (No 2FA):
{
"success": true,
"message": "Login successful",
"data": {
"token": "user_access_token",
"user": {
"id": 1,
"username": "testuser",
"role": 1,
"quota": 1000000
}
}
}✅ Exemple de réponse réussie (2FA requis):
{
"success": true,
"message": "Please enter the two-step verification code",
"data": {
"require_2fa": true
}
}❗ Exemple de réponse en cas d'échec:
{
"success": false,
"message": "The administrator has turned off password login"
}🧾 Description du champ:
username(String) : Nom d'utilisateur, obligatoirepassword(String) : Mot de passe, obligatoirerequire_2fa(booléen): indique si une authentification à deux facteurs est requise
Notification de paiement Epay
- Nom de l'interface : Notification de paiement Epay
- Méthode HTTP:GET
- Chemin:
/api/user/epay/notify - Exigence d'authentification:Public
- Description de la fonction : Gère les notifications de rappel de paiement du système Epay
💡 Exemple de demande:
_// Usually called back automatically by the payment system, no need to call it manually _
_// ExampleURL: /api/user/epay/notify?trade_no=USR1NO123456&money=10.00&trade_status=TRADE_SUCCESS_✅ Exemple de réponse réussie:
{
"success": true,
"message": "Payment successful"
}❗ Exemple de réponse en cas d'échec:
{
"success": false,
"message": "The order does not exist or has been processed"
}🧾 Description du champ:
trade_no(String) : Numéro d'ordre de la transactionmoney(String) : Montant du paiementtrade_status(String) : Statut de la transactionsign(String): Vérification de la signature
Répertorier tous les groupes (version non authentifiée)
- Nom de l'interface:Liste de tous les groupes
- Méthode HTTP:GET
- Chemin:
/api/user/groups - Exigence d'authentification:Public
- Description de la fonction:Récupère des informations sur tous les groupes d'utilisateurs du système, accessibles sans connexion
💡 Exemple de demande:
const response = await fetch('/api/user/groups', {
method: 'GET',
headers: {
'Content-Type': 'application/json'
}
});
const data = await response.json();✅ Exemple de réponse réussie:
{
"success": true,
"message": "",
"data": {
"default": {
"ratio": 1.0,
"desc": "Default grouping"
},
"vip": {
"ratio": 0.8,
"desc": "VIPGroup"
},
"auto": {
"ratio": "automatic",
"desc": "Automatically select the best grouping"
}
}
}❗ Exemple de réponse en cas d'échec:
{
"success": false,
"message": "Failed to obtain group information"
}🧾 Description du champ:
data (Objet): Mappage des informations de groupe
- Clé (Chaîne): Nom du groupe
ratio(Nombre/Chaîne): Rapport de groupe, "automatique" (auto) signifie sélection automatiquedesc(String) : Description du groupe
🔐 Authentification utilisateur requise
Déconnexion
- Nom de l'interface:Déconnexion
- Méthode HTTP:GET
- Chemin:
/api/user/logout - Exigence d'authentification:Utilisateur
- Description de la fonction:Efface la session utilisateur et se déconnecte
💡 Exemple de demande:
const response = await fetch('/api/user/logout', {
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": ""
}❗ Exemple de réponse en cas d'échec:
{
"success": false,
"message": "Session clear failed"
}🧾 Description du champ:
Aucun paramètre de requête
Opérations utilisateur en libre-service
🔐 Authentification utilisateur requise
Obtenir les groupes d'utilisateurs actuels
- Nom de l'interface:Obtenir les groupes d'utilisateurs actuels
- Méthode HTTP:GET
- Chemin:
/api/user/self/groups - Exigence d'authentification:Utilisateur
- Description de la fonction : Récupère les informations de groupe disponibles pour l'utilisateur actuellement connecté, y compris le rapport et la description du groupe
💡 Exemple de demande:
const response = await fetch('/api/user/self/groups', {
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": {
"default": {
"ratio": 1.0,
"desc": "Default grouping"
},
"vip": {
"ratio": 0.8,
"desc": "VIPGroup"
},
"auto": {
"ratio": "automatic",
"desc": "Automatically select the best grouping"
}
}
}❗ Exemple de réponse en cas d'échec:
{
"success": false,
"message": "Failed to obtain group information"
}🧾 Description du champ:
data (Objet): Mappage des informations de groupe disponibles pour l'utilisateur
- Clé (Chaîne): Nom du groupe
ratio(Nombre/Chaîne): Rapport de groupe, "automatique" (auto) signifie sélectionner automatiquement le groupe optimaldesc(String) : Description du groupe
Obtenir un profil personnel
- Nom de l'interface:Obtenir un profil personnel
- Méthode HTTP:GET
- Chemin:
/api/user/self - Exigence d'authentification:Utilisateur
- Description de la fonction:Récupère les informations détaillées de l'utilisateur actuel, y compris les autorisations, le quota, les paramètres, etc.
💡 Exemple de demande:
const response = await fetch('/api/user/self', {
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,
"username": "testuser",
"display_name": "Test User",
"role": 1,
"status": 1,
"email": "user@example.com",
"group": "default",
"quota": 1000000,
"used_quota": 50000,
"request_count": 100,
"aff_code": "ABC123",
"aff_count": 5,
"aff_quota": 10000,
"aff_history_quota": 50000,
"inviter_id": 0,
"linux_do_id": "",
"setting": "{}",
"stripe_customer": "",
"sidebar_modules": "{\"chat\":{\"enabled\":true}}",
"permissions": {
"can_view_logs": true,
"can_manage_tokens": true
}
}
}❗ Exemple de réponse en cas d'échec:
{
"success": false,
"message": "Failed to obtain user information"
}🧾 Description du champ:
id(Numéro): ID utilisateurusername(Chaîne) : Nom d'utilisateurdisplay_name(Chaîne): Nom d'affichagerole(Numéro): Rôle utilisateur, 1 pour un utilisateur standardstatus(Numéro) : Statut utilisateur, 1=Normal, 2=Désactivéemail(Chaîne): Adresse e-mailgroup(Chaîne): Groupe attribuéquota(Nombre): Quota totalused_quota(Nombre): Quota utilisérequest_count(Nombre): nombre de demandesaff_code(Chaîne): Code d'affiliationaff_count(Nombre): Nombre d'affiliésaff_quota(Nombre): Quota de récompense d'affiliationaff_history_quota(Nombre): Quota d'affiliation historiqueinviter_id(Numéro): ID de l'invitélinux_do_id(Chaîne): ID de compte LinuxDosetting(String): chaîne JSON des paramètres utilisateurstripe_customer(Chaîne): ID client Stripesidebar_modules(String): chaîne JSON de configuration du module de la barre latéralepermissions(Objet): informations sur les autorisations de l'utilisateur
Obtenez la visibilité du modèle
- Nom de l'interface:Obtenir la visibilité du modèle
- Méthode HTTP:GET
- Chemin:
/api/user/models - Exigence d'authentification:Utilisateur
- Description de la fonction:Récupère la liste des modèles d'IA accessibles à l'utilisateur actuel
💡 Exemple de demande:
const response = await fetch('/api/user/models', {
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": [
"gpt-5.5",
"claude-sonnet-5-5",
"gemini-3.5-flash",
"deepseek-v4-flash"
]
}❗ Exemple de réponse en cas d'échec:
{
"success": false,
"message": "Failed to get model list"
}🧾 Description du champ:
data (Array): Liste des noms de modèles accessibles à l'utilisateur
Modifier le profil personnel
- Nom de l'interface:Modifier le profil personnel
- Méthode HTTP:PUT
- Chemin:
/api/user/self - Exigence d'authentification:Utilisateur
- Description de la fonction: met à jour les informations personnelles de l'utilisateur ou les paramètres de la barre latérale
💡 Exemple de demande (mettre à jour les informations personnelles):
const response = await fetch('/api/user/self', {
method: 'PUT',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
},
body: JSON.stringify({
display_name: "New Display Name",
email: "newemail@example.com"
})
});
const data = await response.json();💡 Exemple de demande (mettre à jour les paramètres de la barre latérale):
const response = await fetch('/api/user/self', {
method: 'PUT',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
},
body: JSON.stringify({
sidebar_modules: JSON.stringify({
chat: { enabled: true, playground: true },
console: { enabled: true, token: true }
})
})
});
const data = await response.json();✅ Exemple de réponse réussie:
{
"success": true,
"message": "Update successful"
}❗ Exemple de réponse en cas d'échec:
{
"success": false,
"message": "Input is illegal"
}🧾 Description du champ:
display_name(String): Nom d'affichage, facultatifemail(String): Adresse e-mail, facultatifpassword(String) : Nouveau mot de passe, facultatifsidebar_modules(String) : chaîne JSON de configuration du module Sidebar, en option
Supprimer le compte
- Nom de l'interface:Supprimer le compte
- Méthode HTTP:DELETE
- Chemin:
/api/user/self - Exigence d'authentification:Utilisateur
- Description de la fonction:Supprime le compte utilisateur actuel
💡 Exemple de demande:
const response = await fetch('/api/user/self', {
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 en cas d'échec:
{
"success": false,
"message": "Cannot delete super administrator account"
}🧾 Description du champ:
Aucun paramètre de requête
Générer un jeton d'accès au niveau de l'utilisateur
- Nom de l'interface:Générer un jeton d'accès au niveau de l'utilisateur
- Méthode HTTP:GET
- Chemin:
/api/user/token - Exigence d'authentification:Utilisateur
- Description de la fonction:Génère un nouveau jeton d'accès pour l'utilisateur actuel, utilisé pour les appels API
💡 Exemple de demande:
const response = await fetch('/api/user/token', {
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": "`<YOUR_API_KEY>`"
}❗ Exemple de réponse en cas d'échec:
{
"success": false,
"message": "Failed to generate token"
}🧾 Description du champ:
data (String): Jeton d'accès généré
Obtenez des informations sur le code d'affiliation
- Nom de l'interface:Obtenir des informations sur le code d'affiliation
- Méthode HTTP:GET
- Chemin:
/api/user/aff - Exigence d'authentification:Utilisateur
- Description de la fonction:Récupère ou génère le code d'affiliation de l'utilisateur, utilisé pour inviter de nouveaux utilisateurs à s'inscrire
💡 Exemple de demande:
const response = await fetch('/api/user/aff', {
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": "ABC123"
}❗ Exemple de réponse en cas d'échec:
{
"success": false,
"message": "Failed to obtain promotion code"
}🧾 Description du champ:
data (String): Le code d'affiliation de l'utilisateur. Si elle n'existe pas, une chaîne aléatoire de 4 caractères sera automatiquement générée
Rechargement direct du quota
- Nom de l'interface:Rechargement direct du quota
- Méthode HTTP:POST
- Chemin:
/api/user/topup - Exigence d'authentification:Utilisateur
- Description de la fonction:Utilise un code de remboursement pour recharger le quota du compte
💡 Exemple de demande:
const response = await fetch('/api/user/topup', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
},
body: JSON.stringify({
key: "REDEEM123456"
})
});
const data = await response.json();✅ Exemple de réponse réussie:
{
"success": true,
"message": "Redemption successful",
"data": 100000
}❗ Exemple de réponse en cas d'échec:
{
"success": false,
"message": "The redemption code is invalid or has been used"
}🧾 Description du champ:
key(Chaîne): Code de remboursement, obligatoiredata(Nombre): renvoie le montant du quota échangé en cas de succès
Soumettre l'ordre de paiement
- Nom de l'interface:Soumettre l'ordre de paiement
- Méthode HTTP:POST
- Chemin:
/api/user/pay - Exigence d'authentification:Utilisateur
- Description de la fonction:Crée un ordre de paiement en ligne, prenant en charge plusieurs méthodes de paiement
💡 Exemple de demande:
const response = await fetch('/api/user/pay', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
},
body: JSON.stringify({
amount: 10000,
payment_method: "alipay",
top_up_code: ""
})
});
const data = await response.json();✅ Exemple de réponse réussie:
{
"success": true,
"message": "success",
"data": {
"pid": "12345",
"type": "alipay",
"out_trade_no": "USR1NO123456",
"notify_url": "https://example.com/notify",
"return_url": "https://example.com/return",
"name": "TUC10000",
"money": "10.00",
"sign": "abc123def456"
},
"url": "https://pay.example.com/submit"
}❗ Exemple de réponse en cas d'échec:
{
"success": false,
"message": "The recharge amount cannot be less than 1000"
}🧾 Description du champ:
amount(Nombre): Montant de la recharge, doit être supérieur ou égal au quota de recharge minimumpayment_method(String) : Mode de paiement, tel que « alipay », « wxpay », etc.top_up_code(String) : Code de recharge, facultatifdata(Objet) : Paramètres du formulaire de paiementurl(String): URL de soumission du paiement
Calculer le montant du paiement
- Nom de l'interface:Calculer le montant du paiement
- Méthode HTTP:POST
- Chemin:
/api/user/amount - Exigence d'authentification:Utilisateur
- Description de la fonction:Calcule le montant réel du paiement correspondant au quota de recharge spécifié
💡 Exemple de demande:
const response = await fetch('/api/user/amount', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
},
body: JSON.stringify({
amount: 10000,
top_up_code: ""
})
});
const data = await response.json();✅ Exemple de réponse réussie:
{
"success": true,
"message": "success",
"data": "10.00"
}❗ Exemple de réponse en cas d'échec:
{
"success": false,
"message": "The recharge amount cannot be less than 1000"
}🧾 Description du champ:
amount(Nombre): Montant de recharge, doit être supérieur ou égal au Quota de recharge minimumtop_up_code(String) : Code de recharge, facultatifdata(String) : Montant réel requis pour le paiement (Yuan)
Transfert de quota d'affiliation
- Nom de l'interface:Transfert de quota d'affiliation
- Méthode HTTP:POST
- Chemin:
/api/user/aff_transfer - Exigence d'authentification:Utilisateur
- Description de la fonction:Convertit le quota de récompense d'affiliation en quota utilisable
💡 Exemple de demande:
const response = await fetch('/api/user/aff_transfer', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
},
body: JSON.stringify({
quota: 50000
})
});
const data = await response.json();✅ Exemple de réponse réussie:
{
"success": true,
"message": "Transfer successful"
}❗ Exemple de réponse en cas d'échec:
{
"success": false,
"message": "Insufficient invitation quota!"
}🧾 Description du champ:
quota (Nombre): Le montant de Quota à convertir doit être supérieur ou égal au Quota unitaire minimum
Mettre à jour les paramètres utilisateur
- Nom de l'interface:Mettre à jour les paramètres utilisateur
- Méthode HTTP:PUT
- Chemin:
/api/user/setting - Exigence d'authentification:Utilisateur
- Description de la fonction: met à jour la configuration des paramètres personnels de l'utilisateur
💡 Exemple de demande:
const response = await fetch('/api/user/setting', {
method: 'PUT',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
},
body: JSON.stringify({
theme: "dark",
language: "zh-CN",
notifications: {
email: true,
browser: false
}
})
});
const data = await response.json();✅ Exemple de réponse réussie:
{
"success": true,
"message": "Settings updated successfully"
}❗ Exemple de réponse en cas d'échec:
{
"success": false,
"message": "Setting format error"
}🧾 Description du champ:
- Le corps de la demande peut contenir n'importe quel champ de paramètre utilisateur, soumis au format JSON