# Diffuser des missions par API

## Étape 1 : créer une clé API dans le tableau de bord

{% hint style="danger" %}
**Cette étape nécessite l'aide d'un chargé de déploiement** avec qui vous êtes en contact. Cette personne pourra générer cette clé pour vous.
{% endhint %}

<figure><img src="/files/Pu5X8MT0VA9Iym3RW0RQ" alt=""><figcaption></figcaption></figure>

## Étape 2 : récupérer les missions

L'**endpoint /mission permet de récupérer les missions** qui vous sont disponibles. [Voir la documentation](/api-reference/mission-mission/recuperer.md).

## Étape 3 : formater le visuel des missions récupérées via l'API sur votre site

#### Page 1 : Présenter une liste de mission d'engagement sur une page dédiée sur votre site

L'utilisateur accède à la liste des missions **récupérées via l'API Engagement** sur votre plateforme. Exemple d'implémentation

{% hint style="success" %}
*Exemple d'intégration*

* *Cette page propose des filtres  (comme la localisation, la date de début, la durée de la mission, le domaine (le thème), et le type d'engagement (bénévolat ou volontariat)*
* *Cette page propose également la liste des missions que vous diffusez avec les informations clés (titre de la mission, nom de la structure d'accueil, adresse d'exécution de la mission, domaine, type d'engagement). Pour rappel,* [*le modèle de données de missions récupérables est disponible ici*](/diffuser-des-missions/modele-de-donnees-dune-mission-dengagement.md)*.*
  {% endhint %}

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG18aCd8mNuBlmkXXgR3Q%2Fuploads%2FtPt5UamOZ1KQ99sS4YdL%2Fimage.png?alt=media&#x26;token=3c1b5c77-d6dc-4d2d-94cf-684f402ac9bb" alt=""><figcaption><p>Page "liste de missions"</p></figcaption></figure>

**Page 2** : En cliquant sur une carte "mission", l'utilisateur peut alors consulter le détail des missions de bénévolat ou de volontariat avant de cliquer sur le **bouton d'action** que vous aurez ajouté à cette page.

L'utilisateur est alors **redirigé** sur le site de l'annonceur de la mission et peut proposer sa candidature.

<figure><img src="/files/lgRzjOgSvMFGFN971Qjc" alt=""><figcaption><p>Exemple de page de détail de mission</p></figcaption></figure>

NB : Retrouvez plus d'informations sur notre site vitrine 👇🏻

{% embed url="<https://api-engagement.beta.gouv.fr/diffuser-les-missions-de-partenaires/#api>" %}

## Étape 4 : Paramétrer le tracking des diffusions de missions

{% hint style="danger" %}
Cette étape est obligatoire pour pourvoir diffuser les missions de l'API Engagement.

Cet [article](/diffuser-des-missions/tracking-des-candidatures.md) décrit comment mettre en place le tracking obligatoire des vues que vous générerez sur votre site / application.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.api-engagement.beta.gouv.fr/diffuser-des-missions/diffuser-des-missions-dengagement-sur-mon-site/diffuser-des-missions-par-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.