• Prérequis
• Récupérer son Bearer Token
• Télécharger Postman et s’y connecter
• Modifier le statut d’une intervention
• Récupérer l’uuid de l’intervention
• Requête Postman pour modifier le statut de l’intervention
• Requête Postman pour récupérer l’ID du rapport
• Requête Postman pour récupérer le rapport

Prérequis

Récupérer son Bearer Token

👉 Qu’est-ce qu’un Bearer Token ?

C’est une clé d’accès temporaire (comme un mot de passe) qui prouve à l’API que vous êtes bien autorisé à effectuer des actions.

Connectez-vous sur Ermeo avec vos identifiants et le workspace de votre choix.

Ouvrez la console de votre navigateur en faisant clic droit + Inspect :

Allez ensuite dans Network et cliquez sur la dernière requête affichée.

Un panneau va s’ouvrir. Allez dans l’onglet Headers et cherchez la ligne Authorization.

La valeur commencera par le mot Bearer :

Les valeurs indiquées dessous sont votre Bearer Token à copier :

Télécharger Postman et s’y connecter

👉 Qu’est-ce que Postman ?

C’est un outil qui permet de tester facilement des appels API, sans écrire de code. Vous pouvez y préparer vos requêtes comme si vous envoyiez des messages à l’API.

1. Téléchargez Postman au lien suivant : https://www.postman.com/
2. Créez une Collection pour y enregistrer vos requêtes (une collection = un dossier où ranger vos tests).

3. Ajoutez une requête en cliquant sur Add a request :

4. Dans votre nouvelle requête :

• Allez dans Authorization
• Choisissez le type Bearer Token
• Collez la valeur de votre token récupéré précédemment

Modifier le statut d’une intervention

Nous allons envoyer une première requête pour modifier le statut d’une intervention.

👉 Exemple d’usage : remettre une intervention archivée en statut Terminéou récupérer un rapport d’intervention.

Récupérer l’uuid de l’intervention

👉 Qu’est-ce qu’un uuid ?

C’est un identifiant unique (comme une carte d’identité numérique) qui permet de désigner précisément une intervention.

Sur la plateforme Ermeo, l’uuid se trouve directement dans l’URL de l’intervention :

C’est le code compris entre le dernier “/” et le “?”.

Requête Postman pour modifier le statut de l’intervention

Dans Postman, ouvrez la requête que vous avez préparée.

Les paramètres de la requête sont :

• Type : PUT (👉 signifie que vous mettez à jour une ressource existante)
• URL :

https://api-v2.ermeo.com/api/v1/interventions/{{uuid}}

Remplacez {{uuid}} par le vrai uuid de votre intervention (⚠️ sans les accolades).

• Body :

Dans Postman, allez dans Body > Raw > JSON et collez :

{
    "status": "restore"
}

Voici à quoi ressemblera votre requête dans Postman ainsi que le retour que vous recevrez :

Requête Postman pour récupérer l’ID du rapport

Maintenant, nous allons demander à l’API de nous renvoyer le rapport lié à cette intervention.

La requête sera :

• Type : POST
• URL :
Copy

https://api-v2.ermeo.com/api/v1/interventions/{{uuid}}

(remplacez {{uuid}} par celui de votre intervention)

• Vous obtiendrez une réponse JSON similaire à celle-ci :

{
    ...
    "reports": [
        {
            "id": "b5417644-db53-4922-b268-419161f0ea45",
            "code": "20250905_1119_articles_17570639706086_5170052"
        }
    ]
}

👉 Le champ "id" à l’intérieur de "reports" correspond à l’uuid du rapport.

C’est cette valeur qu’il faudra utiliser dans la prochaine requête.

Vous allez pouvoir alors récupérer le report_id qui sera nécessaire pour la requête de récupération du rapport.

C’est la valeur en vert comprise ici :

"reports": [
        {
            "id": "b5417644-db53-4922-b268-419161f0ea45",

Requête Postman pour récupérer le rapport

Enfin, lançons la requête pour récupérer le rapport.

• Type : PUT
• URL :
Copy

https://api-v2.ermeo.com/api/v1/reports/{{uuid du rapport}}

(remplacez {{uuid du rapport}} par l’id trouvé à l’étape précédente)

• Body (toujours en Raw > JSON) :

{
    "status": "restore"
}

👉 "restore" signifie ici restaurer le rapport.

<aside>⚠️ Si le rapport est encore “en cours”, vous devrez d’abord le passer en `"done"` (terminé), puis en `"restore"`. Consultez la [documentation API](https://ermeo.stoplight.io/docs/api-documentation/0c127ff911ea5-get-access-and-refresh-tokens) pour voir toutes les actions possibles. </aside>