# Ocost-API
> Was die Ocost-API tut (Geschäftsbelege als strukturierte Daten lesen, durchsuchen), ihre Adresse, Schlüssel, Format und Routen.

Schicken Sie Ocost Ihre Geschäftsbelege, etwa Rechnungen, Bestellungen und Verträge. Ocost liest, legt ab, bucht und gleicht sie ab, und Sie bekommen jeden als strukturiertes JSON zurück. Außerdem durchsuchen Sie alles, was Ihr Unternehmen in Ocost aufbewahrt.

| Was | Wert |
| --- | --- |
| Adresse | `https://api.ocost.io/public/v1` |
| Schlüssel | `Authorization: Bearer ocost_sk_…`, aus [Einstellungen › Entwickler](https://app.ocost.io/settings/api) |
| Format | JSON, Dateien als `multipart/form-data`, Fehler als RFC-9457-Problems |
| Belege | [`ocost.document.v1`](https://ocost.io/docs/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://ocost.io/docs/de/quickstart.md). Die [API-Referenz](https://ocost.io/docs/openapi.json) enthält jedes Feld. Was Ocost in jedem Land liest, steht unter [Deutschland](https://ocost.io/docs/de/germany.md) und [Ukraine](https://ocost.io/docs/de/ukraine.md).

## Mit KI-Assistenten nutzen

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

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

Ein Prompt für eine Odoo-Anbindung:

```text
Lies https://ocost.io/docs/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.
```

## Siehe auch

- [Schnellstart](https://ocost.io/docs/de/quickstart.md): Fünf Schritte zur ersten Rechnung als JSON: registrieren, Schlüssel erstellen, ein PDF schicken, warten, bis es gelesen ist, den Beleg lesen. curl, Python und JavaScript.
- [Eine Datei schicken und lesen](https://ocost.io/docs/de/files.md): Eine Datei schicken, sicher erneut schicken, warten, bis sie gelesen ist, ihre Belege lesen, das Original holen, sie löschen.
- [Einen Assistenten verbinden](https://ocost.io/docs/de/mcp.md): Einen Assistenten mit dem MCP-Server verbinden (https://api.ocost.io/public/mcp, dieselben Schlüssel): Claude Code, Claude Desktop, Cursor, claude.ai und ChatGPT über OAuth und jeder Client.
- [Der Beleg](https://ocost.io/docs/de/document.md): Das Schema ocost.document.v1 in den Begriffen der EN 16931 (auf UBL und CII abbildbar): ein Beispiel, Art und Richtung, Quellen, Prüfungen, Versionen und jedes Feld und jeder Wert.
- Auf ocost.io: [API und MCP](https://ocost.io/produkt/api-und-mcp), [Preise](https://ocost.io/preise)
