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

# API REST

Utilisez l’API REST de Missive pour enrichir les conversations, automatiser les brouillons, Synchroniser les contacts et plus encore.

L’API Missive vous permet d’enrichir les conversations Missive avec du contenu provenant de n’importe où sur le web. Vous pouvez également automatiser des tâches telles que la création et l’envoi de brouillons, la synchronisation des contacts et plus encore.

<div data-with-frame="true"><img src="https://3750542494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FegxqkD7AXM4n11rNf5qI%2Fuploads%2Fgit-blob-d4c7502fa58585f3a1b3050bb1672f806ff44dd6%2Fpost%20demo%20837ff16f2134b2eb4887a40565599235342f710c7fcf8da425fc5afe91d554ca.png?alt=media" alt="Exemple d’un message créé à l’aide de l’API REST" width="563"></div>

p. ex. une action dans une autre application insérant un message dans une conversation.

#### Notions de base

L’API est un ensemble d’endpoints avec une méthode (p. ex. `POST`) et une URL sous la forme :

```
https://public.missiveapp.com/v1/:endpoint_name
```

#### Authentification

Pour commencer à utiliser l’API, vous devez d’abord obtenir votre API token. Obtenez-le dans vos Préférences Missive, cliquez sur le **API** onglet, puis le **Créer un nouveau token** lien.

{% hint style="info" %}
Vous devez faire partie d’une Organisation abonnée au [plan Productive](https://missiveapp.com/pricing) pour générer des API tokens.
{% endhint %}

Vous devez transmettre votre token utilisateur sous forme de `Bearer` token dans le `Authorization` en-tête HTTP.

{% code title="Exemple de requête" %}

```http
POST /v1/drafts
Host: public.missiveapp.com
Authorization: Bearer missive_pat-26pApm_QTmyhLLbA...FwoFGmJ6x-6fikpQ
```

{% endcode %}

{% hint style="info" %}
Tous les API tokens sont personnels. Il n’existe aucun token au niveau de l’Organisation ni spécifique à un compte partagé. Votre token personnel a accès à tout compte auquel vous pouvez accéder dans Missive, y compris aux Comptes partagés. Utilisez les paramètres account ou mailbox dans vos requêtes pour filtrer les résultats afin de n’afficher qu’un compte partagé spécifique.
{% endhint %}

#### Réponses

Toutes les Réponses de l’API sont formatées en [JSON](http://www.json.org/), y compris les erreurs. Les requêtes réussies `POST` peuvent renvoyer le [201](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes) code d’état sans corps.

#### Évaluer les Réponses

Vous devez déduire la réussite de vos requêtes à partir du code d’état HTTP renvoyé. Une requête réussie renverra soit un [200](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes) ou [201](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes) code d’état.

#### Corps des requêtes POST

Vous devez envoyer explicitement les requêtes POST avec `Content-Type: application/json`.

{% code title="Exemple de POST" %}

```http
POST /v1/drafts
Host: public.missiveapp.com
Authorization: Bearer missive_pat-26pApm_QTmyhLLbA...FwoFGmJ6x-6fikpQ
Content-Type: application/json

{"drafts":{}}
```

{% endcode %}

#### IDs de ressource

Pour interagir avec des ressources via l’API, vous aurez besoin de l’ `ID`. Par exemple, si vous souhaitez appliquer un libellé à une conversation lors de la création d’un message, vous aurez besoin du libellé `ID`. Vous pouvez obtenir les IDs de ces ressources en ouvrant les Paramètres de l’API et en cliquant sur l’onglet IDs de ressource.

<div data-with-frame="true"><img src="https://3750542494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FegxqkD7AXM4n11rNf5qI%2Fuploads%2Fgit-blob-df98688126a968a54a0aa12f7fe7b7040b2445a3%2Fresource%20ids%20f49af9ae85108c87a6db51903e6f25c86583020b057d5e415b8eeaaa528d243a.png?alt=media" alt="Trouvez les IDs de ressource dans vos Paramètres de l’API"></div>

Paramètres > API > IDs de ressource

Dernière mise à jour le 24 février 2020

<details>

<summary>Besoin de réponses plus précises ?</summary>

[Contactez-nous](/docs/developers/fr/contact.md)

</details>


---

# 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://missiveapp.com/docs/developers/fr/rest-api.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.