# API-ul Ocost
> Ce face API-ul Ocost (citește documente de afaceri ca date structurate și caută în ele), adresa, cheile, formatul și rutele sale.

Trimiteți la Ocost documentele firmei, de exemplu facturi, comenzi și contracte. Ocost le citește, le arhivează, le înregistrează și le potrivește, iar dumneavoastră primiți fiecare înapoi ca JSON structurat. Puteți căuta și în tot ce păstrează firma dumneavoastră în Ocost.

| Ce | Valoare |
| --- | --- |
| Adresă | `https://api.ocost.io/public/v1` |
| Cheie | `Authorization: Bearer ocost_sk_…`, din [Setări › Dezvoltatori](https://app.ocost.io/settings/api) |
| Format | JSON, fișiere ca `multipart/form-data`, erori ca probleme RFC 9457 |
| Documente | [`ocost.document.v1`](https://ocost.io/docs/ro/document.md), în termenii EN 16931 |
| Unde | În UE. Documentele nu antrenează niciodată un model. |

## Rutele

| Rută | Ce face |
| --- | --- |
| `POST /public/v1/files` | Trimite un fișier |
| `GET /public/v1/files` | Fișierele modificate de la un moment sau un cursor |
| `GET /public/v1/files/{file_id}` | Un fișier și starea lui |
| `GET /public/v1/files/{file_id}/content` | Octeții originali |
| `GET /public/v1/files/{file_id}/document` | Primul său document |
| `GET /public/v1/documents/{document_id}` | Orice document |
| `DELETE /public/v1/files/{file_id}` | Șterge definitiv un fișier |
| `GET /public/v1/search` | Caută după cuvinte și după sens |

Începeți cu [Pornirea rapidă](https://ocost.io/docs/ro/quickstart.md). [Referința API](https://ocost.io/docs/openapi.json) conține fiecare câmp. Ce citește Ocost în fiecare țară găsiți la [Germania](https://ocost.io/docs/ro/germany.md) și [Ucraina](https://ocost.io/docs/ro/ukraine.md).

## Utilizare cu asistenți AI

Claude, ChatGPT, Cursor și alți asistenți citesc aceste ghiduri ca Markdown:

- `https://ocost.io/docs/llms.txt`: o hartă a tuturor ghidurilor
- `https://ocost.io/docs/llms-full.txt`: toate ghidurile într-un singur fișier
- `https://ocost.io/docs/openapi.json`: documentul OpenAPI
- **Copiați pagina pentru AI**, lângă fiecare titlu

Un prompt pentru o integrare cu Odoo:

```text
Citește https://ocost.io/docs/llms.txt și ghidurile la care trimite, mai întâi ghidul Odoo. Apoi scrie un modul Odoo 19 care trimite PDF-ul unei facturi de furnizor în ciornă la API-ul Ocost, interoghează fișierul până când este citit și completează partenerul, numărul, datele și liniile facturii din ocost.document.v1 al acestuia, fără s-o înregistreze. Păstrează cheia API în parametrul de sistem ocost.api_key.
```

## Vezi și

- [Pornire rapidă](https://ocost.io/docs/ro/quickstart.md): Cinci pași până la prima factură ca JSON: înregistrați-vă, creați o cheie, trimiteți un PDF, așteptați până este citit, citiți-i documentul. curl, Python și JavaScript.
- [Trimiteți și citiți un fișier](https://ocost.io/docs/ro/files.md): Trimiteți un fișier, retrimiteți-l în siguranță, așteptați până este citit, citiți-i documentele, obțineți originalul, ștergeți-l.
- [Conectați un asistent](https://ocost.io/docs/ro/mcp.md): Conectați un asistent la serverul MCP (https://api.ocost.io/public/mcp, aceleași chei): Claude Code, Claude Desktop, Cursor, claude.ai și ChatGPT prin OAuth, și orice client.
- [Documentul](https://ocost.io/docs/ro/document.md): Schema ocost.document.v1 în termenii EN 16931 (se mapează pe UBL și CII): un exemplu, tip și direcție, surse, verificări, versiuni și fiecare câmp și valoare.
- Pe ocost.io: [API and MCP](https://ocost.io/en/product/api-and-mcp), [Pricing](https://ocost.io/en/pricing)
