API Organisation courante

Récupérer l'organisation rattachée à une clé d'API.

Renvoie l'organisation à laquelle appartient la clé d'API. Utilisez ce point d'entrée quand une intégration doit identifier l'espace de travail de la clé.

Point d'entrée

GET /api/v1/me

GET /api/v1/organization est le chemin canonique et renvoie la même réponse ; /api/v1/me en est un alias. Les deux exécutent l'outil get_organization, ils ne peuvent donc pas diverger.

Authentification

Créez une clé d'API depuis les réglages de l'organisation :

/orgs/{orgSlug}/settings/api-keys

Envoyez la clé dans l'en-tête x-api-key :

x-api-key: VOTRE_CLE_API

L'authentification par jeton porteur est également acceptée :

Authorization: Bearer VOTRE_CLE_API

Réponse

Champ	Type	Description
`organization.id`	chaîne	Identifiant de l'organisation
`organization.name`	chaîne	Nom affiché de l'organisation
`organization.slug`	chaîne \| null	Slug utilisé dans les URL de l'application

Exemples

cURL

curl -H "x-api-key: VOTRE_CLE_API" \
  https://chambree.fr/api/v1/me

JavaScript

const response = await fetch("https://chambree.fr/api/v1/me", {
  headers: {
    "x-api-key": process.env.CHAMBREE_API_KEY!,
  },
});

if (!response.ok) {
  throw new Error(`Appel /api/v1/me en échec : ${response.status}`);
}

const data = await response.json();

Erreurs

Statut	Description
`401`	Clé absente, invalide, expirée ou restreinte
`404`	L'organisation de la clé n'existe plus
`500`	Erreur interne du serveur