# Ocost-API

Schicken Sie Ocost einen Geschäftsbeleg, bekommen Sie ihn als JSON zurück, und durchsuchen Sie alles, was Ihr Unternehmen dort aufbewahrt.

- **Adresse:** `https://api.ocost.io/public/v1`
- **Schlüssel:** `Authorization: Bearer ocost_sk_…`, aus [Einstellungen › API](/settings/api)
- **Format:** JSON; Dateien als `multipart/form-data`; Fehler als RFC-9457-Problems
- **Belege:** Rechnungen, Gutschriften, Quittungen, Lieferscheine, Bestellungen, Angebote, Verträge, Abrechnungen, Mahnungen, als `ocost.document.v1` in den Begriffen der EN 16931 (auf UBL und CII abbildbar)
- **Wo:** Ocost läuft in der EU; Belege trainieren nie ein Modell

## Die Routen

| Route | Zweck |
| --- | --- |
| `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}` | Ein beliebiger 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://app.ocost.io/developers/de/quickstart.md). Jedes Feld steht in der [API-Referenz](https://app.ocost.io/developers/openapi.json), erzeugt aus `https://api.ocost.io/public/v1/openapi.json`.

## Mit KI-Assistenten nutzen

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

- `https://app.ocost.io/llms.txt`: eine Übersicht aller Anleitungen
- `https://app.ocost.io/llms-full.txt`: alle Anleitungen in einer Datei (auf Englisch)
- `https://app.ocost.io/developers/openapi.json`: das OpenAPI-Dokument
- **Als Markdown kopieren**, neben dem Titel jeder Anleitung

Ein Prompt für eine Odoo-Anbindung:

```text
Lies https://app.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.
```