---
title: "Référence API"
url: "https://rolebase.io/fr/api"
---

[Rolebase](/) ⟩ [Référence API](/fr/api)

# Référence API

Accédez et gérez vos organisations Rolebase de manière programmatique via l'API GraphQL.

## Clés API

Générez des clés API pour votre organisation sur [/apps](/apps). Ces clés authentifient toutes les requêtes envoyées à l’API.

## Point d’accès GraphQL

**Production :** `https://api.rolebase.io/graphql`

**Développement local :** `http://localhost:8888/graphql`

L’API est propulsée par [Hasura](https://hasura.io/docs/2.0/index/), vous pouvez donc vous référer à la documentation Hasura pour les capacités de requête avancées.

## Démarrage rapide

### Avec curl

```
curl -X POST https://api.rolebase.io/graphql \
  -H "x-api-key: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ org { id, name } }"}'
```

### Avec Apollo Client

```
import {
  ApolloClient,
  InMemoryCache,
  createHttpLink,
  gql,
} from '@apollo/client'

// Créer le client avec les en-têtes d'authentification
const client = new ApolloClient({
  link: createHttpLink({
    uri: 'https://api.rolebase.io/graphql',
    headers: {
      'x-api-key': 'YOUR_API_KEY_HERE',
    },
  }),
  cache: new InMemoryCache(),
})

// Exemple de requête
const { data } = await client.query({
  query: gql`
    query GetOrganization {
      org {
        id
        name
      }
    }
  `,
})
```

** Authentification**

Incluez l’en-tête `x-api-key` dans chaque requête. Votre clé API détermine à quelles données d’organisation vous pouvez accéder et quelles opérations sont autorisées.

## Entités

Chaque entité prend en charge les opérations GraphQL standard (requête, mutation) en fonction des permissions de votre clé API.

### Organisation et membres

*   [`org`](/fr/api/org) — Organisations
*   [`member`](/fr/api/member) — Membres de l’organisation
*   [`org_file`](/fr/api/org_file) — Fichiers de l’organisation
*   [`org_subscription`](/fr/api/org_subscription) — Abonnements de l’organisation

### Cercles et rôles

*   [`circle`](/fr/api/circle) — Cercles organisationnels
*   [`circle_leader`](/fr/api/circle_leader) — Attributions de leadership des cercles
*   [`circle_link`](/fr/api/circle_link) — Liens entre cercles
*   [`circle_member`](/fr/api/circle_member) — Appartenances aux cercles
*   [`circle_participant`](/fr/api/circle_participant) — Participants des cercles (vue)
*   [`role`](/fr/api/role) — Rôles au sein des cercles

### Réunions

*   [`meeting`](/fr/api/meeting) — Réunions
*   [`meeting_attendee`](/fr/api/meeting_attendee) — Participants aux réunions
*   [`meeting_recurring`](/fr/api/meeting_recurring) — Configurations de réunions récurrentes
*   [`meeting_step`](/fr/api/meeting_step) — Étapes et points de l’ordre du jour
*   [`meeting_template`](/fr/api/meeting_template) — Modèles de réunion