---
title: Présentation de l'API
description: Les endpoints de Human Plugin, leurs relations, les règles de réponse communes et ce que l'API ne fournit pas.
canonical: https://developer.unico.io/fr/human-plugin/api-reference/overview
locale: fr
generated_by: markdown-export
---

# Présentation de l'API

Trois endpoints de processus et deux sondes de santé.

Human Plugin est servi en HTTP simple sur le port que vous configurez (`8080` par défaut). L'URL de base est l'endroit où vous exposez le conteneur dans votre réseau, par exemple `http://human-plugin.internal:8080`.

| Méthode | Chemin | Objectif |
| --- | --- | --- |
| `POST` | `/v1/processes` | [Créer un processus](/fr/human-plugin/api-reference/create-process), avec l'un des [flux](/fr/human-plugin/api-reference/create-process#flows) |
| `GET` | `/v1/processes/{id}` | [Obtenir un processus](/fr/human-plugin/api-reference/get-process) |
| `GET` | `/v1/processes/{id}/selfie` | [Obtenir le selfie](/fr/human-plugin/api-reference/get-selfie) |
| `GET` | `/health/live` | Liveness. Voir [Santé et supervision](/fr/human-plugin/self-hosting/health-and-monitoring) |
| `GET` | `/health/ready` | Readiness (ping de la base de données) |

Il n'existe pas d'endpoint pour lister, supprimer ou rechercher des processus, ni de récepteur de webhook.

## Règles valables pour chaque appel

- **Aucun en-tête d'authentification.** Human Plugin ne valide pas les appelants. Restreignez plutôt l'accès réseau : voir [Réseau et sécurité](/fr/human-plugin/self-hosting/networking-and-security).
- **JSON uniquement**, avec des noms de champs en camelCase.
- **Les réponses sont `Cache-Control: no-store`.**
- **Les erreurs** utilisent une seule enveloppe, `{"message": "INVALID_REQUEST", "details": []}`. Voir [Erreurs et nouvelles tentatives](/fr/human-plugin/api-reference/errors-and-retries).
- **`id` est l'id de processus de Human Plugin.** Conservez-le depuis la création : c'est ainsi que vous relirez le processus plus tard.

## Séquence type

```mermaid
sequenceDiagram
  participant B as Your back-end
  participant H as Human Plugin
  B->>H: POST /v1/processes
  H-->>B: 201 + id, state, data
  B->>H: GET /v1/processes/{id}
  H-->>B: 200 + id, state, data (humanToken, ndocs)
```

Suite : [Créer un processus](/fr/human-plugin/api-reference/create-process).