API/API d’un membre de l’organisation

API d’un membre de l’organisation

Récupérez un membre de l’organisation avec une clé API.

Récupère un membre de l’organisation propriétaire de la clé API. Une clé étant limitée à une organisation, seul l’identifiant du membre est nécessaire.

Utilisez GET /api/v1/members pour obtenir la liste complète des membres. Utilisez GET /api/v1/me pour obtenir l’identifiant, le nom ou le slug de l’organisation.

Point d’entrée

GET /api/v1/members/:memberId

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

Paramètres du chemin

ParamètreTypeDescription
memberIdstringIdentifiant de l’adhésion

Réponse

ChampTypeDescription
memberobjectMembre de l’organisation de la clé

Objet membre

ChampTypeDescription
idstringIdentifiant de l’adhésion
rolestringRôle, par exemple owner
createdAtnumberDate de création en millisecondes
user.idstringIdentifiant utilisateur
user.namestringNom affiché
user.emailstringAdresse e-mail
user.imagestring | nullURL de l’avatar

Exemples

cURL

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

JavaScript

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

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

const data = await response.json();

Erreurs

StatutDescription
401Clé absente, non valide, expirée ou limitée
404L’organisation ou le membre demandé n’existe plus
500Erreur interne du serveur
API de la liste des membresAPI des outils