> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solya.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Aperçu pour développeurs

> Intégrez l'API REST Solya — authentification, conventions et où trouver la référence complète.

L'API REST Solya expose les capacités de la plateforme — navigation de catalogue, plans d'inventaire, analyses, alertes,
tags, workflows et opérations de plateforme de données — aux programmes externes, scripts et agents IA.

<CardGroup cols={2}>
  <Card title="Authentification" icon="key" href="/fr/developers/authentication">
    Les trois schémas d'authentification et comment créer et utiliser un token de compte de service.
  </Card>

  <Card title="Effectuer des requêtes" icon="paper-plane" href="/fr/developers/making-requests">
    URL de base, pagination, filtrage et introspection de votre token.
  </Card>

  <Card title="Codes d'erreur" icon="circle-exclamation" href="/fr/developers/error-codes">
    Enveloppe de réponse, codes d'erreur et mappage du statut HTTP.
  </Card>

  <Card title="Référence API" icon="code">
    La référence complète et toujours à jour des endpoints — ouvrez l'onglet **Référence API**.
  </Card>

  <Card title="Passerelle MCP" icon="plug" href="/fr/mcp/overview">
    Piloter Solya depuis un agent IA (Claude, Cursor) via le Model Context Protocol.
  </Card>
</CardGroup>

## Conventions en un coup d'œil

* **URL de base** — `https://app.solya.app` (production). Les endpoints vivent sous `/api/`.
* **Format** — Corps de requête et de réponse en JSON.
* **Auth** — envoyez `Authorization: Bearer <token>`. Consultez
  [Authentification](/fr/developers/authentication).
* **Tenancy** — chaque token et session est scopé à une **organisation** ; vous ne lisez ou n'écrivez
  jamais que les données de cette organisation.
* **Réponses** — une enveloppe cohérente avec un drapeau `success` et, en cas d'échec, un
  `errorCode` stable sur lequel vous pouvez vous brancher. Consultez [Codes d'erreur](/fr/developers/error-codes).

<Note>
  L'onglet **Référence API** est généré directement à partir de la spécification OpenAPI de Solya, donc
  il correspond toujours à l'API en cours d'exécution. Cette section Développeurs ajoute les
  concepts transversaux que la référence par endpoint ne répète pas.
</Note>