# 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="https://2489729786-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG18aCd8mNuBlmkXXgR3Q%2Fuploads%2FZqNikSIGgmRMYbibV5h5%2Fimage.png?alt=media&#x26;token=b9e6d011-913a-4965-8557-1fee96df8c93" 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](https://app.gitbook.com/s/ubkRP59ZFCzK5T16bZo1/mission-mission/recuperer).

## É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*](https://doc.api-engagement.beta.gouv.fr/diffuser-des-missions/modele-de-donnees-dune-mission-dengagement)*.*
  {% 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="https://2489729786-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG18aCd8mNuBlmkXXgR3Q%2Fuploads%2F8c4VBbb6HboXNlpV1Hk8%2Fimage.png?alt=media&#x26;token=cdb9c291-8702-4262-bf48-f0ca5de135f6" 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](https://doc.api-engagement.beta.gouv.fr/diffuser-des-missions/tracking-des-candidatures) décrit comment mettre en place le tracking obligatoire des vues que vous générerez sur votre site / application.
{% endhint %}