# Gestion des opérations API

Il est courant d’avoir des opérations qui ne sont pas encore totalement stables ou qui doivent être progressivement abandonnées. GitBook prend en charge plusieurs extensions OpenAPI pour vous aider à gérer ces scénarios.

### Marquer une opération comme expérimentale, alpha ou bêta

Utiliser `x-stability` pour indiquer qu’un point de terminaison est instable ou en cours de développement. Cela aide les utilisateurs à éviter les points de terminaison qui ne sont pas prêts pour la production. Valeurs prises en charge : `experimental`, `alpha`, `beta`.

<pre class="language-yaml" data-title="openapi.yaml"><code class="lang-yaml">paths :
  /pet :
    put :
      operationId: updatePet
<strong>      x-stability: experimental
</strong></code></pre>

### Déprécier une opération

Pour marquer une opération comme obsolète, ajoutez l’ `deprecated: true` attribut.

<pre class="language-yaml" data-title="openapi.yaml"><code class="lang-yaml">paths :
  /pet :
    put :
      operationId: updatePet
<strong>      deprecated: true
</strong></code></pre>

Indiquez éventuellement quand la prise en charge se termine en incluant `x-deprecated-sunset`

<pre class="language-yaml" data-title="openapi.yaml"><code class="lang-yaml">paths :
  /pet :
    put :
      operationId: updatePet
<strong>      deprecated: true
</strong><strong>      x-deprecated-sunset: 2030-12-05
</strong></code></pre>

### Masquer une opération de la référence de l’API

Pour masquer une opération de votre référence d’API, ajoutez `x-internal: true` ou `x-gitbook-ignore: true` attribut.

<pre class="language-yaml" data-title="openapi.yaml"><code class="lang-yaml">paths :
  /pet :
    put :
      operationId: updatePet
<strong>      x-internal: true
</strong></code></pre>

### Masquer un exemple de réponse

Ajoutez l’ `x-hideSample: true` attribut à un objet de réponse pour l’exclure de la section des exemples de réponse.

<pre class="language-yaml" data-title="openapi.yaml"><code class="lang-yaml">paths :
  /pet :
    put :
      operationId: updatePet
<strong>      responses :
</strong><strong>        200:
</strong><strong>          x-hideSample: true
</strong></code></pre>

### Personnaliser le préfixe d’autorisation et l’espace réservé du jeton

Vous pouvez personnaliser le préfixe d’autorisation (par exemple, `Bearer`, `Token`ou une chaîne personnalisée) ainsi que l’espace réservé du jeton affiché lors de l’utilisation de schémas de sécurité dans GitBook.

Dans votre spécification OpenAPI, sous `components.securitySchemes`, définissez votre schéma comme ceci :

<pre class="language-yaml" data-title="openapi.yaml"><code class="lang-yaml">components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: Authorization
<strong>      x-gitbook-prefix: Token
</strong><strong>      x-gitbook-token-placeholder: YOUR_CUSTOM_TOKEN
</strong></code></pre>

Ces extensions :

* `x-gitbook-prefix` définit le préfixe ajouté avant le jeton.
  * exemple : `Authorization: <x-gitbook-prefix> YOUR_API_TOKEN`
* `x-gitbook-token-placeholder` définit la valeur de jeton par défaut.
  * exemple : `Authorization: Bearer <x-gitbook-token-placeholder>`

{% hint style="warning" %}
`x-gitbook-prefix` n’est pas pris en charge pour les schémas de sécurité `http` car ces schémas doivent respecter les définitions d’authentification IANA standard. [En savoir plus](https://www.iana.org/assignments/http-authschemes/http-authschemes.xhtml)
{% endhint %}


---

# 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://gitbook.com/docs/documentation/fr/api-references/guides/managing-api-operations.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.