> For the complete documentation index, see [llms.txt](https://www.center.daxium-air.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.center.daxium-air.com/user-documentation/documentation-utilisateur/connect/api-documentation.md).

# Documentation API

Accéder à l'API REST Daxium-Air pour des intégrations sur mesure et une automatisation avancée.

Daxium-Air propose une **API REST** complète pour les développeurs qui souhaitent créer des intégrations sur mesure ou automatiser des workflows de manière programmatique.

## Ce que vous pouvez faire

* **Lire** les fiches, les structures et les données utilisateurs
* **Créer et mettre à jour** des fiches de manière programmatique
* **Rechercher** des fiches avec des filtres avancés
* **Gérer** les utilisateurs et les groupes
* **Générer** des rapports à la demande

## Authentification

L'API utilise une **authentification par jeton OAuth**. Vous aurez besoin d'une clé API et d'un secret générés depuis le back office Daxium-Air, ainsi que d'un nom d'utilisateur et d'un mot de passe, pour générer un jeton OAuth. Ce jeton est ensuite utilisé pour authentifier vos requêtes.

1. Générez une **clé API et un secret** dans Webservices > Clés d'API puis en cliquant sur "+ Nouveau"
2. Entrez une description de la clé API pour la nommer, et sauvegardez

<figure><img src="https://1911583818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ymrtuLI4wkVYM9CeCbX%2Fuploads%2FkNOISEA4cWWrf4V8KgMJ%2Fimage.png?alt=media&amp;token=42c0b97e-4ea4-4bc1-89c4-2d6fbd0b66a7" alt=""><figcaption></figcaption></figure>

## Permissions

Pour utiliser l'API, l'utilisateur authentifié doit avoir la licence **Mobile** activée. Les droits sur les formulaires, les fiches, les [groupes](https://www.center.daxium-air.com/user-documentation/documentation-utilisateur/components-concepts-terminology.md#groupe), etc. sont hérités de cet utilisateur, exactement comme dans l'application.

{% hint style="info" %}
Les licences **Lecteur Web** et **Contributeur Web** n'ont aucun effet sur l'accès à l'API. Par exemple, un utilisateur disposant à la fois de la licence Mobile et de la licence Lecteur Web pourra tout de même créer et modifier des fiches via l'API.
{% endhint %}

## Prise en main

1. Générez un [**jeton d'authentification**](https://www.center.daxium-air.com/api-reference/authorization) à l'aide de la clé API et du secret, ainsi que du nom d'utilisateur et du mot de passe de l'utilisateur pour lequel vous souhaitez vous authentifier
2. Incluez le jeton d'authentification dans l'en-tête `Authorization` de vos requêtes
3. Consultez la référence de l'API pour connaître les points de terminaison disponibles

{% hint style="info" %}
La référence complète de l'API est disponible dans la section [**Référence API**](https://www.center.daxium-air.com/api-reference/doc-api) de ce site de documentation.
{% endhint %}


---

# 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://www.center.daxium-air.com/user-documentation/documentation-utilisateur/connect/api-documentation.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.
