# Points de terminaison

> Le tableau complet des points de terminaison de LMSP 1.0 avec méthode, chemin, niveau d’exigence et rôle, ainsi que les conventions sur les chemins, l’authentification et les points de terminaison facultatifs.

Source: https://madeforagent.com/fr/lmsp/1.0/endpoints/
Language: fr
Specification: LMSP 1.0 (draft)
Updated: 2026-11-08

## 4.1 Tableau des points de terminaison {#table}

Un service conforme **DOIT** implémenter chaque point de terminaison marqué obligatoire. Il **PEUT** implémenter les facultatifs, et les signale par les indicateurs de capacité de sa [description de service](https://madeforagent.com/fr/lmsp/1.0/discovery.md#service-description).

| Méthode | Chemin | Exigence | Rôle |
| --- | --- | --- | --- |
| GET | `/.well-known/lmsp.json` | Obligatoire | [Découverte du service et de ses capacités](https://madeforagent.com/fr/lmsp/1.0/discovery.md#service-description) |
| GET | `/lmsp/v1/openapi.json` | Obligatoire | Spécification de l’interface lisible par machine |
| GET | `/lmsp/v1/health` | Obligatoire | [Contrôle de vivacité et de disponibilité](https://madeforagent.com/fr/lmsp/1.0/common-rules.md#health) |
| POST | `/lmsp/v1/pair` | Obligatoire | [Échanger un code d’appairage contre un jeton porteur](https://madeforagent.com/fr/lmsp/1.0/security.md#pairing) |
| GET | `/lmsp/v1/models` | Obligatoire | [Lister les modèles locaux](https://madeforagent.com/fr/lmsp/1.0/models.md#list) |
| GET | `/lmsp/v1/models/{model_id}` | Obligatoire | [Obtenir un modèle](https://madeforagent.com/fr/lmsp/1.0/models.md#operations) |
| POST | `/lmsp/v1/responses` | Obligatoire | [Génération synchrone ou en streaming](https://madeforagent.com/fr/lmsp/1.0/responses.md#request) |
| GET | `/lmsp/v1/responses/{response_id}` | Facultatif | [Récupérer une réponse stockée](https://madeforagent.com/fr/lmsp/1.0/responses.md#sync) |
| POST | `/lmsp/v1/tasks` | Obligatoire | [Créer une tâche de génération asynchrone](https://madeforagent.com/fr/lmsp/1.0/tasks.md#create) |
| GET | `/lmsp/v1/tasks/{task_id}` | Obligatoire | [Obtenir une tâche asynchrone](https://madeforagent.com/fr/lmsp/1.0/tasks.md#create) |
| POST | `/lmsp/v1/tasks/{task_id}/cancel` | Obligatoire | [Annuler une tâche asynchrone](https://madeforagent.com/fr/lmsp/1.0/tasks.md#cancel) |
| GET | `/lmsp/v1/tasks/{task_id}/events` | Facultatif | [S’abonner au flux d’événements ou le reprendre](https://madeforagent.com/fr/lmsp/1.0/tasks.md#events) |
| POST | `/lmsp/v1/models/{model_id}/load` | Facultatif | [Précharger un modèle](https://madeforagent.com/fr/lmsp/1.0/models.md#operations) |
| POST | `/lmsp/v1/models/{model_id}/unload` | Facultatif | [Décharger un modèle](https://madeforagent.com/fr/lmsp/1.0/models.md#operations) |

Les points de terminaison compatibles OpenAI sous `/v1` et les points de terminaison facultatifs compatibles Ollama sont listés à la [page 8](https://madeforagent.com/fr/lmsp/1.0/compatibility.md).

## 4.2 Conventions {#conventions}

- **Corps.** Les corps des requêtes et des réponses sont en JSON (`application/json`), sauf les flux d’événements (`text/event-stream`) et les erreurs (`application/problem+json`).
- **Paramètres de chemin.** Un nom entre accolades, tel que `{model_id}`, est un espace réservé. Les valeurs **DOIVENT** être encodées en pourcentage. Un identifiant de modèle comme `qwen3:14b-q4_k_m` est envoyé sous la forme `qwen3%3A14b-q4_k_m`.
- **Authentification.** Chaque point de terminaison exige `Authorization: Bearer <token>`, sauf `/.well-known/lmsp.json`, `/lmsp/v1/openapi.json`, `/lmsp/v1/health` et `/lmsp/v1/pair`.
- **Points de terminaison facultatifs.** Un point de terminaison facultatif que le service n’implémente pas **DOIT** répondre `501 Not Implemented` avec le code d’erreur `unsupported_capability`.
- **Versions et erreurs.** Les requêtes peuvent porter des en-têtes de version, et chaque erreur utilise un format unique. Les deux sont définis à la [page 9](https://madeforagent.com/fr/lmsp/1.0/common-rules.md).
- **Contrat.** Le document OpenAPI publié à l’adresse [`/lmsp/1.0/openapi.json`](https://madeforagent.com/lmsp/1.0/openapi.json) est la forme lisible par machine de cette page. Le texte fait foi lorsque les deux diffèrent.
