> For the complete documentation index, see [llms.txt](https://help.ingeneo.septeo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.ingeneo.septeo.com/ingeneo-compta/supervision-datas/api/clef-abonne-api.md).
# Clef abonné API
{% hint style="info" %}
**Où le trouver :** Menu **API › Clef abonné API**
{% endhint %}
{% hint style="success" %}
**En bref** — Cet écran vous permet d'obtenir et de révoquer les clefs propres à votre abonnement qui donnent accès aux API Ingeneo Compta : une clef d'accès complet et une clef d'accès en lecture seule.
* Pour produire ou changer la clef d'accès complet : bouton \[Générer une nouvelle clef], puis confirmez ; la clef précédente est révoquée.
* Pour donner un simple droit de consultation à un prestataire : bouton \[Générer une nouvelle clef d'accès en lecture seule], puis relevez la clef avec le pictogramme « Œil ».
* Pour révoquer une clef : pictogramme « Autres actions » (trois points verticaux), puis « Supprimer la clef actuelle » ou « Supprimer la clef d'accès en lecture seule ».
{% endhint %}
Cette option vous permet d'obtenir et de révoquer les clefs qui donnent accès aux API Ingeneo Compta. Elle en propose deux, présentées l'une au-dessous de l'autre dans deux rubriques : une clef d'accès complet et une clef d'accès en lecture seule.
Écran « Clef abonné API » de la nouvelle interface
Ces clefs sont propres à votre abonnement : elles ne se saisissent pas, le logiciel les produit lui-même lorsque vous cliquez sur l'un des boutons de génération. L'écran ne comporte d'ailleurs aucun bouton d'enregistrement.
## Rubrique « Clé API (accès complet) »
Rubrique « Clé API (accès complet) »
Elle s'ouvre sur la phrase « Pour avoir accès à l'ensemble des API Ingeneo Compta, vous devez disposer d’une clef unique qui est propre à chaque abonné. »
**Votre clef** : cette zone présente la clef en cours, masquée par des points. Elle n'est pas modifiable : vous ne pouvez ni la saisir, ni la corriger.
Le pictogramme « Œil » placé à droite de la zone porte l'infobulle « Afficher ou masquer la clef ». Un premier clic affiche la clef en clair, ce qui vous permet de la relever pour la communiquer à l'outil qui appellera les API ; un second la masque de nouveau. Cette commande est purement visuelle : elle ne modifie ni n'enregistre rien.
La rubrique se referme sur la phrase « Vous avez la possibilité de changer cette clef en cliquant sur le bouton « Générer une nouvelle clef » ou, si vous ne voulez plus utiliser les API Ingeneo Compta, de la révoquer en choisissant « Supprimer la clef actuelle » dans le menu ⋮ de la barre d’actions. »
## Rubrique « Clé API (lecture seule) »
Rubrique « Clé API (lecture seule) »
Elle s'ouvre sur la phrase « Si vous souhaitez permettre à d'autres prestataires d'accéder à l'API de Ingeneo Compta, vous pouvez disposer d'une clef supplémentaire ne leur permettant que de consulter les données sans pouvoir les modifier ou les supprimer. »
**Clef d'accès en lecture seule** : cette zone se présente et se comporte exactement comme la précédente : la clef y est masquée, elle n'est pas modifiable, et le même pictogramme « Œil », avec la même infobulle « Afficher ou masquer la clef », l'affiche puis la masque.
Cette seconde clef est celle que vous confiez à un prestataire à qui vous ne voulez donner qu'un droit de consultation : toute demande qui ne serait pas une simple lecture est refusée lorsqu'elle est présentée avec cette clef.
La rubrique se referme sur la phrase « Vous avez la possibilité de changer cette clef en cliquant sur le bouton « Générer une nouvelle clef d'accès en lecture seule » ou, si vous ne voulez plus utiliser les API Ingeneo Compta, de la révoquer en choisissant « Supprimer la clef d'accès en lecture seule » dans le menu ⋮ de la barre d’actions. »
## La barre d'actions de bas d'écran
Rubrique « La barre d'actions de bas d'écran »
La barre d'actions, en bas à droite de l'écran, porte deux boutons suivis d'un pictogramme de trois points verticaux. De gauche à droite :
bouton **\[Générer une nouvelle clef d'accès en lecture seule]** : il produit la clef de consultation, et c'est également par lui que vous la changez.
bouton **\[Générer une nouvelle clef]** : il produit la clef d'accès complet. Comme l'indique la rubrique, c'est aussi par lui que vous changez la clef existante.
**Pictogramme « Autres actions »** (trois points verticaux) : il déroule un menu de deux entrées, écrites en rouge. « Supprimer la clef actuelle » révoque la clef d'accès complet ; « Supprimer la clef d'accès en lecture seule » révoque la clef de consultation.
Chacune de ces quatre commandes dépend d'un droit qui lui est propre : selon les droits accordés à votre code utilisateur, l'une d'elles peut donc manquer alors que les autres sont présentes. Leur affichage ne dépend en revanche pas de l'existence d'une clef. Lorsque la clef correspondante n'existe pas, la commande de suppression ne supprime rien : elle vous signale que vous ne disposez d'aucune clef de ce type.
Lorsqu'une clef existe déjà, la génération d'une nouvelle clef révoque la précédente : la fenêtre de confirmation vous le rappelle.
---
# 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://help.ingeneo.septeo.com/ingeneo-compta/supervision-datas/api/clef-abonne-api.md?ask=&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.
