> For the complete documentation index, see [llms.txt](https://docs.dydu.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dydu.ai/developpeurs/reference-api.md).

# Référence API

Les API de la solution Dydu vous permettent de faire dialoguer votre bot depuis votre propre interface, de récupérer vos données (conversations, base de connaissances) et d'automatiser certaines opéra

## Avant de commencer

Pour utiliser la plupart des API, vous avez besoin de deux éléments :

1. **L'identifiant de votre bot (botUUID)** : il est affiché sur la page **Préférences > Api > Accès aux APIs**. Voir [Accès aux APIs](https://docs.dydu.ai/developpeurs/reference-api/acces-aux-apis).
2. **Une autorisation** : un jeton à placer dans l'en-tête `Authorization` de vos requêtes. Voir [Authentification](https://docs.dydu.ai/developpeurs/reference-api/authentification).

Dans les exemples de cette partie, remplacez `<serveur>` par l'adresse de votre plateforme (par exemple « app1.earth.doyoudreamup.com »).

## Les API disponibles

<table data-search="false"><thead><tr><th>Page</th><th>À quoi elle sert</th></tr></thead><tbody><tr><td><a href="https://docs.dydu.ai/developpeurs/reference-api/acces-aux-apis">Accès aux APIs</a></td><td>Trouver l'identifiant du bot, ouvrir l'interface Swagger et modifier les préférences du bot.</td></tr><tr><td><a href="https://docs.dydu.ai/developpeurs/reference-api/authentification">Authentification</a></td><td>Construire l'en-tête <code>Authorization</code> (Basic ou Bearer).</td></tr><tr><td><a href="https://docs.dydu.ai/developpeurs/reference-api/boite-de-dialogue-api">Boîte de dialogue API</a></td><td>Faire dialoguer le bot depuis votre application (API REST <code>/api/chat</code> et WebSocket).</td></tr><tr><td><a href="https://docs.dydu.ai/developpeurs/reference-api/champ-de-recherche">Champ de recherche</a></td><td>Proposer des connaissances pendant que l'utilisateur tape sa question.</td></tr><tr><td><a href="https://docs.dydu.ai/developpeurs/reference-api/export-des-conversations">Export des Conversations</a></td><td>Exporter les conversations en XML, CSV ou Excel.</td></tr><tr><td><a href="https://docs.dydu.ai/developpeurs/reference-api/import-export-base-de-connaissances">Import/Export Base de connaissances</a></td><td>Exporter, importer ou supprimer la base de connaissances d'un bot.</td></tr><tr><td><a href="https://docs.dydu.ai/developpeurs/reference-api/import-export-du-bot">Import/Export du bot</a></td><td>Dupliquer un bot complet, par exemple de la production vers la recette.</td></tr><tr><td><a href="https://docs.dydu.ai/developpeurs/reference-api/gestion-des-utilisateurs-du-bms">Gestion des utilisateurs du BMS</a></td><td>Créer ou modifier les comptes utilisateurs du BMS.</td></tr><tr><td><a href="https://docs.dydu.ai/developpeurs/reference-api/api-de-statut-du-serveur">API de statut du serveur</a></td><td>Surveiller l'état de votre plateforme.</td></tr></tbody></table>

{% hint style="info" %}
La configuration des moteurs NLP externes se fait dans le BMS, depuis **Préférences > Api > NLP externes** : elle est décrite dans la page [NLP externes](https://docs.dydu.ai/preferences/api/nlp-externes.md).
{% endhint %}
