Alloovium

Capabilities

Meta

Endpoints d'identité et d'introspection. Une capability aujourd'hui — meta.whoami — conçue pour être très bon marché et sans effets de bord afin que vous puissiez l'utiliser comme vérification de démarrage SDK ou sonde de santé à débit limité.

meta.whoami

GET/api/v2/me

Identité et capabilities de l'identifiant appelant. Ne requiert aucun scope — n'importe quelle clé valide ou token OAuth fonctionne.

scope: (none)cost: 1idempotent

Requête

bash
curl -sS https://api.alloovium.com/api/v2/me \
  -H "Authorization: Bearer $ALLOOVIUM_API_KEY"

Ni corps ni paramètres de requête. L'API dérive tout depuis le header header — passez soit une clé API (live / test) soit un Bearer JWT OAuth.

Réponse (clé API)

json
{
  "user_id": "1f02d9ef-...",
  "tenant_id": "c7a1e9c2-...",
  "auth_method": "api_key",
  "email": "alex@example.com",
  "api_key_id": "2e5f09bb-...",
  "api_key_name": "Backend worker — production",
  "api_key_prefix": "ak_live_AB7K",
  "environment": "live",
  "rate_limit_tier": "pro",
  "scopes": [
    "chat:read",
    "chat:write",
    "templates:read",
    "templates:write",
    "vault:read",
    "vault:write",
    "workflows:read",
    "workflows:write"
  ]
}

Réponse (OAuth)

json
{
  "user_id": "1f02d9ef-...",
  "tenant_id": "c7a1e9c2-...",
  "auth_method": "oauth",
  "client_id": "client_9a8b7c6d",
  "scopes": [
    "chat:read",
    "vault:read"
  ]
}

Les principaux OAuth n'exposent pas d'email, de nom de clé API, d'environnement ou de niveau de limite de débit. Si vous en avez besoin, utilisez une clé API à la place.

Champs

ChampToujours présent ?Notes
user_idyesUUID of the Alloovium user behind the credential.
tenant_idyesUUID of the tenant the user belongs to.
auth_methodyes'api_key' or 'oauth'.
scopesyesSorted list of capability scopes granted to the credential.
emailapi_key onlyUser's email address (may be null if unset).
api_key_idapi_key onlyUUID of the specific key resolving the request.
api_key_nameapi_key onlyHuman-readable label the user gave the key.
api_key_prefixapi_key onlyFirst ~12 chars of the raw key, e.g. 'ak_live_AB7K'.
environmentapi_key only'live' or 'test'.
rate_limit_tierapi_key onlyfree / standard / pro / enterprise.
client_idoauth onlyOAuth client_id that minted the bearer token.

Utilisez ceci pour l'initialisation du SDK

Appelez capability quand votre SDK démarre. Si ça réussit, vous avez un identifiant fonctionnel ; le tableau scopes vous dit quelles capabilities vous pouvez appeler ; et tier vous dit dans quel bucket se trouve la clé. Parce que le handler ne fait aucun appel base de données, cet endpoint est sous la milliseconde côté serveur.

Ne pas utiliser comme boucle de sonde de liveness

Même à 1 token par appel, une boucle serrée épuisera votre bucket. Si vous voulez un signal de santé continu, interrogez à un intervalle qui respecte votre niveau de limite de débit — voir link.

Voir aussi