> For the complete documentation index, see [llms.txt](https://docs.plenit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.plenit.com/fr/referencia/jetons-api/how-to-create-an-api-token.md).

# Comment créer un jeton API

L’API de Plenit te permet d’automatiser depuis tes propres outils ce que tu fais aujourd’hui dans le panneau, comme créer ou consulter des serveurs. Pour l’utiliser, ton application ou ton script a besoin d’un jeton API : l’identifiant qui la reconnaît auprès de l’API et qui définit à quelles organisations il peut accéder.

{% hint style="success" %}

#### **👍 Ce que vous obtenez**

Un jeton actif avec la portée que tu choisis, prêt à authentifier tes requêtes à l’API.
{% endhint %}

### Avant de commencer

* Se connecter à la plateforme Plenit avec un Utilisateur administrateur de votre Organisation.
* Décider à quelles organisations le jeton aura accès : uniquement à la tienne ou à toutes celles de tes clients.

{% hint style="info" %}

#### **📘 Le jeton appartient à l’organisation, pas à ton compte utilisateur**

Le jeton n’est pas associé à la personne qui le crée, mais à l’organisation. Si cette personne quitte l’entreprise, le jeton continue de fonctionner jusqu’à son expiration ou jusqu’à ce que tu le révoques.
{% endhint %}

### Étape 1. Ouvre la section Jetons API

1. Ouvre le menu de ton profil, dans le coin inférieur gauche du panneau.
2. Dans **Votre Organisation**, cliquez sur **Jetons API**.

<figure><img src="https://2336980375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2FtQJGmomt31cWo4Ko9X3e%2Fapi-tokens-01-menu-perfil.png?alt=media&amp;token=0bc084bc-f0c4-44fd-af71-01d535f22639" alt="Acceso a API Tokens desde el menú del perfil"><figcaption><p>Accès aux jetons API depuis le menu du profil</p></figcaption></figure>

Tu verras la liste des jetons créés dans ton organisation, avec leur état, leur portée et leur date d’expiration.

### Étape 2. Génère un nouveau jeton

Cliquez sur **Générer un nouveau jeton**.

<figure><img src="https://2336980375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2FCgn2KRRLgXwrTpcOafbu%2Fapi-tokens-02-generar-nuevo-token.png?alt=media&amp;token=d0a8708b-7ed0-4dbb-8064-c5c0b249b2c2" alt="Botón Generate new token en la sección API Tokens"><figcaption><p>Bouton Générer un nouveau jeton dans la section Jetons API</p></figcaption></figure>

### Étape 3. Donne-lui un nom et choisis la date d’expiration

1. Saisis dans **Nom** un nom qui te permette de reconnaître à quoi sert le jeton (dans l’exemple, `Intégration ERP`).
2. Si tu veux, ajoute une description dans **Description (facultative)**.
3. Choisissez l'expiration dans **Expiration**: 30, 60, 90 ou 365 jours. À côté de chaque option, tu verras la date exacte à laquelle il expirera.
4. Cliquez sur **Suivant**.

<figure><img src="https://2336980375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fzk0HHhqmo5xSK90JsLhc%2Fapi-tokens-03-nombre-y-caducidad.png?alt=media&amp;token=a7602b2a-dac6-4df5-b893-3aa12acea869" alt="Nombre, descripción y caducidad del token"><figcaption><p>Nom, description et expiration du jeton</p></figcaption></figure>

{% hint style="info" %}

#### **📘 Quelle durée d’expiration choisir**

Plus elle est courte, plus c’est sûr : si le jeton est divulgué, il cesse de fonctionner plus tôt. Pour des tests ou des intégrations ponctuelles, 30 jours suffisent. Pour des intégrations stables, choisis une durée d’expiration plus longue et note la date pour le renouveler à temps.
{% endhint %}

### Étape 4. Choisis la portée

1. Dans **Portée**, choisis à quelles organisations le jeton aura accès :
   * **All organizations**: accès aux ressources de ton organisation et de tous tes clients. Utile si tu gères l’infrastructure de chacun d’eux depuis un seul endroit.
   * **My organization**: accès uniquement aux ressources de l’organisation indiquée. C’est l’option appropriée si tu vas remettre le jeton à un client ou à un tiers.
2. Vérifie **Autorisations**. Aujourd’hui, tous les jetons ont **Contrôle total**: ils peuvent lire, créer, modifier et supprimer n’importe quelle ressource dans les services auxquels ils ont accès.
3. Cliquez sur **Générer le jeton**.

<figure><img src="https://2336980375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2FIpZaqHcYPUwB40T36sFJ%2Fapi-tokens-04-alcance.png?alt=media&amp;token=76efb3e6-6195-4f26-ba4f-46f8e2d8f600" alt="Selección del alcance y permisos del token"><figcaption><p>Sélection de la portée et des autorisations du jeton</p></figcaption></figure>

{% hint style="warning" %}

#### **🚧 Un jeton avec Contrôle total équivaut à un administrateur**

Quiconque possède le jeton peut faire dans ces organisations la même chose qu’un administrateur. Choisis la portée la plus restreinte qui te convienne et ne partage pas le jeton par des canaux non sécurisés.
{% endhint %}

### Étape 5. Copie la clé et enregistre-la

1. Appuie sur l’icône de copie, à côté de la clé.
2. Conserve-la dans un endroit sûr, comme un gestionnaire de mots de passe ou le coffre-fort de secrets de ton application.
3. Cliquez sur **Confirmer**.

<figure><img src="https://2336980375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2FkRrxpl16He9EgLAseHdD%2Fapi-tokens-05-copiar-clave.png?alt=media&amp;token=c6faf798-067b-4684-80c2-2bddb872f72f" alt="Ventana Token created successfully con la clave del token"><figcaption><p>Fenêtre « Jeton créé avec succès » avec la clé du jeton</p></figcaption></figure>

{% hint style="warning" %}

#### **🚧 La clé ne s’affiche qu’une seule fois**

Lorsque tu fermeras cette fenêtre, tu ne pourras plus la revoir. Si tu la perds, tu devras régénérer le jeton, et la clé précédente cessera de fonctionner.
{% endhint %}

### Étape 6. Vérifie que le jeton apparaît dans la liste

Le jeton apparaît dans la liste avec l’état **Actif**, sa portée et sa date d’expiration.

<figure><img src="https://2336980375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2FdC7GBKxRJwjInNFHELIe%2Fapi-tokens-06-token-en-listado.png?alt=media&amp;token=dd3fe3da-17ed-41db-9d8c-a8d8f300643f" alt="Nuevo token activo en el listado de API Tokens"><figcaption><p>Nouveau jeton actif dans la liste des jetons API</p></figcaption></figure>

Les actions effectuées avec ce jeton sont enregistrées dans **Événements**.

### Étapes suivantes

* Comment faire des requêtes à l'API avec votre jeton.
* [Comment modifier, régénérer et révoquer un jeton](/fr/referencia/jetons-api/how-to-edit-regenerate-and-revoke-a-token.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.plenit.com/fr/referencia/jetons-api/how-to-create-an-api-token.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.