# API Ocost
> Ce que fait l'API Ocost (lire des documents commerciaux en données structurées, les rechercher), son adresse, ses clés, son format et ses routes.

Envoyez à Ocost vos documents commerciaux, comme des factures, des commandes et des contrats. Ocost les lit, les classe, les comptabilise et les rapproche, et vous récupérez chacun en JSON structuré. Vous pouvez aussi rechercher tout ce que votre entreprise garde dans Ocost.

| Quoi | Valeur |
| --- | --- |
| Adresse | `https://api.ocost.io/public/v1` |
| Clé | `Authorization: Bearer ocost_sk_…`, depuis [Paramètres › Développeurs](https://app.ocost.io/settings/api) |
| Format | JSON, fichiers en `multipart/form-data`, erreurs en problèmes RFC 9457 |
| Documents | [`ocost.document.v1`](https://ocost.io/docs/fr/document.md), dans les termes de l'EN 16931 |
| Où | Dans l'UE. Les documents n'entraînent jamais un modèle. |

## Les routes

| Route | Fait |
| --- | --- |
| `POST /public/v1/files` | Envoyer un fichier |
| `GET /public/v1/files` | Les fichiers modifiés depuis une date ou un curseur |
| `GET /public/v1/files/{file_id}` | Un fichier et son statut |
| `GET /public/v1/files/{file_id}/content` | Les octets d'origine |
| `GET /public/v1/files/{file_id}/document` | Son premier document |
| `GET /public/v1/documents/{document_id}` | N'importe quel document |
| `DELETE /public/v1/files/{file_id}` | Effacer un fichier pour de bon |
| `GET /public/v1/search` | Rechercher par mots et par sens |

Commencez par le [Démarrage rapide](https://ocost.io/docs/fr/quickstart.md). La [référence de l'API](https://ocost.io/docs/openapi.json) contient chaque champ. Ce qu'Ocost lit dans chaque pays se trouve sous [Allemagne](https://ocost.io/docs/fr/germany.md) et [Ukraine](https://ocost.io/docs/fr/ukraine.md).

## Utiliser avec des assistants IA

Claude, ChatGPT, Cursor et d'autres assistants lisent ces guides en Markdown :

- `https://ocost.io/docs/llms.txt` : une carte de tous les guides
- `https://ocost.io/docs/llms-full.txt` : tous les guides dans un seul fichier
- `https://ocost.io/docs/openapi.json` : le document OpenAPI
- **Copier la page pour l'IA**, à côté de chaque titre

Un prompt pour une intégration Odoo :

```text
Lis https://ocost.io/docs/llms.txt et les guides vers lesquels il renvoie, d'abord celui sur Odoo. Écris ensuite un module Odoo 19 qui envoie le PDF d'une facture fournisseur en brouillon à l'API Ocost, interroge le fichier jusqu'à ce qu'il soit lu, et remplit le partenaire, le numéro, les dates et les lignes de la facture à partir de son ocost.document.v1 sans la comptabiliser. Garde la clé d'API dans le paramètre système ocost.api_key.
```

## Voir aussi

- [Démarrage rapide](https://ocost.io/docs/fr/quickstart.md): Cinq étapes jusqu'à la première facture en JSON : créer un compte, créer une clé, envoyer un PDF, attendre qu'il soit lu, lire son document. curl, Python et JavaScript.
- [Envoyer un fichier et le lire](https://ocost.io/docs/fr/files.md): Envoyer un fichier, le renvoyer sans risque, attendre qu'il soit lu, lire ses documents, récupérer l'original, le supprimer.
- [Connecter un assistant](https://ocost.io/docs/fr/mcp.md): Connecter un assistant au serveur MCP (https://api.ocost.io/public/mcp, les mêmes clés) : Claude Code, Claude Desktop, Cursor, claude.ai et ChatGPT par OAuth, et tout client.
- [Le document](https://ocost.io/docs/fr/document.md): Le schéma ocost.document.v1 dans les termes de l'EN 16931 (transposable en UBL et CII) : un exemple, type et sens, sources, contrôles, versions, et chaque champ et chaque valeur.
- Sur ocost.io: [API and MCP](https://ocost.io/en/product/api-and-mcp), [Pricing](https://ocost.io/en/pricing)
