GET /v1/me

Renvoie l'utilisateur et le tenant auxquels appartient le jeton Bearer. La manière la moins coûteuse de confirmer qu'un jeton est valide avant d'émettre une véritable action.

GET /api/v1/me

Requête

Aucun corps ni paramètre de requête. Juste l'en-tête d'authentification.

curl https://www.qyvo.io/api/v1/me \
  -H "Authorization: Bearer YOUR_TOKEN_HERE"

const me = await fetch('https://www.qyvo.io/api/v1/me', {
  headers: { Authorization: `Bearer ${process.env.QYVO_TOKEN}` },
}).then((r) => r.json());

$me = Http::withToken(env('QYVO_TOKEN'))
    ->get('https://www.qyvo.io/api/v1/me')
    ->json();

import os, httpx
me = httpx.get(
    'https://www.qyvo.io/api/v1/me',
    headers={'Authorization': f"Bearer {os.environ['QYVO_TOKEN']}"},
).json()

Réponse — 200 OK

{
  "id": 42,
  "email": "[email protected]",
  "name": "Romain",
  "tenant": {
    "id": "01HZX9...",
    "name": "Acme Co."
  }
}

Champ	Type	Notes
id	integer	Id utilisateur interne
email	string	Email de connexion de l'utilisateur
name	string | null	Nom d'affichage
tenant.id	UUID	Id de l'espace de travail — la portée sur laquelle opère tout autre endpoint
tenant.name	string	Nom d'affichage de l'espace de travail
tenant	object | null	null si l'utilisateur n'a pas de tenant — tout autre endpoint renverra 422 No workspace configured

Erreurs

Statut	Corps	Cause
401	{"message": "Unauthenticated."}	Jeton manquant, erroné ou révoqué