# Utiliser la console

La console est accessible depuis le lien suivant :

<https://mobilic.beta.gouv.fr/developers/playground>

## Présentation <a href="#presentation" id="presentation"></a>

La console est constituée de 4 parties :

* l'éditeur de requêtes qui occupe l'essentiel de la partie gauche. C'est ici que sont écrites les [opérations](/guides/syntaxe-des-operations-graphql.md).
* les réponses retournées par l'API sur la moitié droite
* le tiroir de documentation qui détaille les actions de l'API, ouvrable depuis le bouton situé tout à gauche
* l'éditeur d'en-têtes de requêtes + variables d'opération situé en bas à gauche

## Authentification <a href="#authentification" id="authentification"></a>

La plupart des requêtes à l'API nécessitent d'être [authentifié via un jeton d'accès](/guides/authentification.md).

Exemple de rajout d'un jeton lié à un rattachement :

```json
{
  "X-CLIENT-ID": 156432124,
  "X-EMPLOYMENT-TOKEN": "06dd5a1a9f9552876c79251dcccd7bbdb7cd5c098b72"
}
```

Exemple de rajout d'un jeton lié à un utilisateur :

```json
{
  "X-CLIENT-ID": 156432124,
  "Authorization" : "Bearer 1234-fefdsfds-1484-fsdfsd-489"
}
```

## Exemple simple <a href="#exemple-simple" id="exemple-simple"></a>

Reprenons l'exemple de l'action de `login` détaillé [ici](/guides/effectuer-une-requete-a-lapi.md#exemple-simple).

Dans l'éditeur de requêtes il n'y a pas besoin de constituer le corps JSON de la requête HTTP, il suffit simplement d'y écrire l'[opération GraphQL](/guides/syntaxe-des-operations-graphql.md).

![Opération de création d'activité dans la console](/files/VxUos0ruDGo7k9rFoNeg)

Puis il suffit de soumettre la requête en cliquant sur le bouton du milieu, en ayant préalablement renseigné les header HTTP d'authentification.

## Editer les variables d'opération <a href="#editer-les-variables-doperation" id="editer-les-variables-doperation"></a>

Il est possible d'utiliser des [variables d'opération](/guides/syntaxe-des-operations-graphql.md#variables-doperation) à l'aide de l'éditeur de variables en bas à gauche.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.mobilic.beta.gouv.fr/guides/utiliser-la-console.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.