aethexDocs
Tableau de bord

Référence API

API Auth (session portail)

Endpoints de session du portail développeur.Ces routes ne font pas partie de la surface API client. Les routes authentifiées du portail — GET/PATCH/DELETE /auth/me, POST /auth/logout, GET /auth/sessions et POST /auth/logout-all — sont protégées par le JWT du portail (Depends(require_developer_jwt)) et renvoient 401 lorsqu'appelées avec une clé API en bearer. Les points d'entrée de connexion (POST /auth/google, POST /auth/magic-link/request, POST /auth/magic-link/verify) et la route de rotation (POST /auth/refresh) ne requièrent pas de JWT — c'est ainsi qu'on en obtient ou qu'on le rafraîchit — et ignorent entièrement les clés API. Les routes retirées POST /auth/register et POST /auth/login renvoient 410 Gone.Obtenez un JWT en vous connectant au portail développeur via Google SSO ou un lien magique par email ; le portail le stocke dans un cookie HttpOnly et relaie les requêtes via portal/api/[[...path]].Le SDK Python expose les wrappers DeveloperClient.get_me/update_me/delete_me/logout pour les routes protégées par JWT ; ils requièrent un JWT du portail et ne fonctionnent pas avec une clé AethexAI. Si vous n'avez qu'une clé API, passez cette page.

URL de base
https://api.aethexai.com/api/v1
Endpoints
6
GET/auth/me

Lit le profil du développeur connecté. JWT du portail uniquement.

Lire le profil développeur courant

Renvoie le profil du développeur dont le JWT autorise la requête. Non appelable avec une clé API client — renvoie 401 face à un en-tête X-API-Key.

Erreurs

1
401Non autorisé

JWT du portail manquant ou invalide. Les clés API ne sont pas acceptées sur ces routes.

Connectez-vous au portail développeur via Google SSO ou un lien magique et laissez le portail relayer ces appels.

PATCH/auth/me

Met à jour `name` et/ou `company` du développeur connecté. JWT du portail uniquement.

Mettre à jour le profil développeur courant

Met à jour name et/ou company sur la ligne du développeur connecté. Les deux champs sont optionnels. Non appelable avec une clé API client.

Corps de la requête

2
  • namestringoptionnel

    Nouveau nom d'affichage. Tronqué ; passez null ou omettez pour ne pas modifier.

  • companystringoptionnel

    Nouveau nom d'entreprise. Tronqué ; passez null ou omettez pour ne pas modifier.

Erreurs

1
401Non autorisé

JWT du portail manquant ou invalide. Les clés API ne sont pas acceptées sur ces routes.

Connectez-vous au portail développeur via Google SSO ou un lien magique et laissez le portail relayer ces appels.

DELETE/auth/me

Supprime (soft-delete) le développeur connecté et désactive toutes ses clés API. JWT du portail uniquement.

Supprimer le compte développeur courant

Supprime (soft-delete) la ligne du développeur connecté et désactive toutes les clés API de son locataire. La réponse efface les cookies de session. Non appelable avec une clé API client.

Erreurs

1
401Non autorisé

JWT du portail manquant ou invalide. Les clés API ne sont pas acceptées sur ces routes.

Connectez-vous au portail développeur via Google SSO ou un lien magique et laissez le portail relayer ces appels.

POST/auth/logout

Révoque la session JWT soutenant le cookie/en-tête courant. JWT du portail uniquement.

Déconnecter la session courante du portail

Révoque la ligne de session côté serveur correspondant au JWT de l'appelant et efface les cookies du portail. Non appelable avec une clé API client.

Erreurs

1
401Non autorisé

JWT du portail manquant ou invalide. Les clés API ne sont pas acceptées sur ces routes.

Connectez-vous au portail développeur via Google SSO ou un lien magique et laissez le portail relayer ces appels.

GET/auth/sessions

Liste les sessions JWT côté serveur actives du développeur. JWT du portail uniquement.

Lister les sessions actives du portail

Renvoie les sessions actives côté serveur du développeur connecté — l'état ligne par ligne que la page « où vous êtes connecté » du portail affiche. La session correspondant au JWT de l'appelant porte is_current: true afin que l'UI puisse l'étiqueter et conditionner l'action de révocation par ligne. Non appelable avec une clé API client.Les champs forensiques (created_ip, last_activity_ip, user_agent) sont best-effort et peuvent être null pour des sessions adoptées depuis des jetons antérieurs au déploiement.

Erreurs

1
401Non autorisé

JWT du portail manquant ou invalide. Les clés API ne sont pas acceptées sur ces routes.

Connectez-vous au portail développeur via Google SSO ou un lien magique et laissez le portail relayer ces appels.

POST/auth/logout-all

Révoque toutes les sessions actives du développeur connecté. JWT du portail uniquement.

Déconnecter toutes les sessions du portail

Révoque toutes les sessions actives côté serveur du développeur connecté — c'est le chemin de récupération « se déconnecter partout ». Inclut la session de l'appelant, la réponse efface donc les cookies du portail. Limité en fréquence par développeur afin qu'un jeton d'accès volé ne puisse pas brûler le chemin de récupération de l'utilisateur légitime. revoked_count indique combien de lignes de session ont été révoquées par cet appel. Non appelable avec une clé API client.

Erreurs

1
401Non autorisé

JWT du portail manquant ou invalide. Les clés API ne sont pas acceptées sur ces routes.

Connectez-vous au portail développeur via Google SSO ou un lien magique et laissez le portail relayer ces appels.