API de l’organisation courante

Récupérez l’organisation associée à une clé API.

Récupère l’organisation propriétaire de la clé API. Utilisez ce point d’entrée lorsqu’une intégration doit identifier l’espace associé à la clé.

Point d’entrée

GET /api/v1/me

GET /api/v1/organization est le chemin canonique ; /api/v1/me reste disponible comme alias. Les deux exécutent l’outil get_organization et renvoient donc toujours le même résultat.

Authentification

Créez une clé API depuis les paramètres de l’organisation :

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

Envoyez-la dans l’en-tête x-api-key :

x-api-key: YOUR_API_KEY

L’authentification Bearer est également acceptée :

Authorization: Bearer YOUR_API_KEY

Réponse

Champ	Type	Description
`organization.id`	string	Identifiant de l’organisation
`organization.name`	string	Nom affiché
`organization.slug`	string \| null	Slug utilisé dans les URL

Exemples

cURL

curl -H "x-api-key: YOUR_API_KEY" \
  https://ndd-seo.fr/api/v1/me

JavaScript

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

if (!response.ok) {
  throw new Error(`Échec de l’API de l’organisation : ${response.status}`);
}

const data = await response.json();

Erreurs

Statut	Description
`401`	Clé absente, non valide, expirée ou limitée
`404`	L’organisation associée n’existe plus
`500`	Erreur interne du serveur