# Ocost-API

Schicken Sie Ocost einen Geschäftsbeleg, etwa eine Rechnung, eine Bestellung oder einen Vertrag. Sie bekommen ihn als JSON zurück und durchsuchen alles, was Ihr Unternehmen in Ocost aufbewahrt.

| Was | Wert |
| --- | --- |
| Adresse | `https://api.ocost.io/public/v1` |
| Schlüssel | `Authorization: Bearer ocost_sk_…`, aus [Einstellungen › API](https://app.ocost.io/settings/api) |
| Format | JSON, Dateien als `multipart/form-data`, Fehler als RFC-9457-Problems |
| Belege | [`ocost.document.v1`](https://docs.ocost.io/de/document.md), in den Begriffen der EN 16931 |
| Wo | In der EU. Belege trainieren nie ein Modell. |

## Die Routen

| Route | Tut |
| --- | --- |
| `POST /public/v1/files` | Eine Datei schicken |
| `GET /public/v1/files` | Seit einem Zeitpunkt oder Cursor geänderte Dateien |
| `GET /public/v1/files/{file_id}` | Eine Datei und ihr Status |
| `GET /public/v1/files/{file_id}/content` | Die Originaldatei |
| `GET /public/v1/files/{file_id}/document` | Ihr erster Beleg |
| `GET /public/v1/documents/{document_id}` | Jeder Beleg |
| `DELETE /public/v1/files/{file_id}` | Eine Datei endgültig löschen |
| `GET /public/v1/search` | Nach Wörtern und Bedeutung suchen |

Beginnen Sie mit dem [Schnellstart](https://docs.ocost.io/de/quickstart.md). Die [API-Referenz](https://docs.ocost.io/openapi.json) enthält jedes Feld.

## Mit KI-Assistenten nutzen

Claude, ChatGPT, Cursor und andere Assistenten lesen diese Anleitungen als Markdown:

- `https://docs.ocost.io/llms.txt`: eine Übersicht aller Anleitungen
- `https://docs.ocost.io/llms-full.txt`: alle Anleitungen in einer Datei
- `https://docs.ocost.io/openapi.json`: das OpenAPI-Dokument
- **Als Markdown kopieren**, neben jedem Titel

Ein Prompt für eine Odoo-Anbindung:

```text
Lies https://docs.ocost.io/llms.txt und die verlinkten Anleitungen, zuerst die zu Odoo. Schreib dann ein Odoo-19-Modul, das das PDF einer Entwurfs-Eingangsrechnung an die Ocost-API schickt, die Datei abfragt, bis sie gelesen ist, und Partner, Nummer, Daten und Positionen der Rechnung aus ihrem ocost.document.v1 füllt, ohne sie zu buchen. Der API-Schlüssel steht im Systemparameter ocost.api_key.
```