API & MCP
Един акаунт. Три начина за достъп: REST, MCP и llms.txt.
Същите 300+ API/MCP инструменти — независимо дали интегрирате чрез REST, работите в AI клиент чрез MCP или предавате llms.txt.
Един акаунт, хостван в ЕС: Зад всеки достъп стои един и същ Document Layer.
- Собствена инфраструктура в ЕС Вашите данни остават в Европа.
- ISO 27001 активен Сигурността е сертифицирана.
- SOC 2 Type II активен Международни стандарти за одит.
- 24+ години опит Доказано. Стабилно. Бъдеще-ориентирано.
Showroom
Какво може да се изгради с PaperOffice
От единичен API извикване до Document Agent: Showroom показва приложения, промпти и технически рецепти.
Автоматична проверка и одобрение на фактури
Екстракция, съпоставяне с доставчици, откриване на дубликати, одобрение и сигурен резултат в един процес.
Document AIПроверка на договори за рискове
Автоматично откриване на клаузи, срокове и отклонения.
ComplianceВалидиране на адреси
Извличане, геокодиране и проверка на данните от документите.
TransformationПодготовка на PDF файлове за агенти
OCR, структура и метаданни за следващи системи.
KnowledgeЗаявки към знанието в реално време
Отговори от текущия документен архив, а не от копия.
Бърз старт
От промпт до първия API-извикване
Без четене на документация: Кодовият агент чете llms.txt и след това познава възможностите, автентикацията и крайните точки.
- Предаване на llms.txt Агентът чете машинно четимото описание на API.
- Свързване на акаунт Акаунт за REST и MCP, токен в заглавката.
- Описание на приложението Опишете с естествен език какво трябва да се създаде.
Read https://api.paperoffice.ai/latest/docs/llms.txt and understand the available Document Operations.
Then build a workflow that:
1) Analyses incoming invoices
2) Checks required fields
3) Returns the result as structured JSON
4) Uses Authorization: Bearer po_ut_YOUR_API_KEYAPI разбран · готов за първия API-извикване
curl -X POST \ "https://api.paperoffice.ai/latest/job/add/workflow" \ -H "Authorization: Bearer po_ut_YOUR_API_KEY" \ -F "[email protected]" \ -F "idp_collection=invoice" \ -F "model=basic-pro-max"import requestsresponse = requests.post( "https://api.paperoffice.ai/latest/job/add/workflow", headers={"Authorization": "Bearer po_ut_YOUR_API_KEY"}, files={"file_1": open("invoice.pdf", "rb")}, data={"idp_collection": "invoice", "model": "basic-pro-max"},)print(response.json())const form = new FormData();form.append("file_1", new Blob([await readFile("invoice.pdf")]), "invoice.pdf");form.append("idp_collection", "invoice");form.append("model", "basic-pro-max");const response = await fetch("https://api.paperoffice.ai/latest/job/add/workflow", { method: "POST", headers: { Authorization: "Bearer po_ut_YOUR_API_KEY" }, body: form,});console.log(await response.json());<?php$ch = curl_init("https://api.paperoffice.ai/latest/job/add/workflow");curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["Authorization: Bearer po_ut_YOUR_API_KEY"], CURLOPT_POSTFIELDS => [ "file_1" => new CURLFile("invoice.pdf"), "idp_collection" => "invoice", "model" => "basic-pro-max", ],]);echo curl_exec($ch);Първо API-извикване
Как изглежда първото API-извикване
POST към /latest/job/add/workflow с файл, колекция и модел — плюс Bearer токен в заглавката. Повече не е нужно.
- Една заглавка
Authorization: Bearer po_ut_YOUR_API_KEY — без OAuth поток, без логика за обновяване, без задължителен SDK.
- Една тръба (pipeline) за всяко извикване
Пътят след /latest/job/add/ посочва тръбата; workflow връща структуриран IDP.
- Резултат или job_id
По подразбиране API поддържа връзката и връща резултата вграден; в противен случай се получава HTTP 202 с job_id и poll_url.
Три достъпа
Как PaperOffice се интегрира в стека
Използвайте точно достъпа, който продуктът или агентът има нужда. Документът остава единственият надежден източник.
За собствени продукти
Извиквайте операции с документи директно от бекенд, работен поток или SaaS.
- JSON-базиран API
- Асинхронни задачи
- Уебхукове и събития
За KI агенти
Вграждане на PaperOffice в Claude, ChatGPT, Cursor и други MCP клиенти.
- Откриване на инструменти
- Директен достъп до документи
- Контролирани действия
За кодиращи агенти
Кодиращият агент разбира веднага възможностите, автентификацията и примерите.
- Не е необходимо SDK
- Машиночетима документация
- Директно копируемо
Въпроси
Често задавани въпроси относно API и MCP
Каква е разликата между REST, MCP и llms.txt?
REST е интерфейсът за собствени продукти, сървърът на MCP предоставя същите инструменти в AI клиенти като Claude, ChatGPT или Cursor, а llms.txt описва и двете по машиночетим начин за кодиращи агенти. И трите достъпа работят на една и съща сметка и един и същ документен слой.
Трябва ли ми SDK?
Не. API използва HTTP и JSON, достатъчен е всеки HTTP клиент. За кодиращи агенти машинночетимото описание се намира на https://api.paperoffice.ai/latest/docs/llms.txt.
Как да се аутентифицирам?
С токен в HTTP заглавката: Authorization: Bearer po_ut_YOUR_API_KEY. Какви видове ключове съществуват и за какво служат, е описано на страницата Аутентификация и ключове.
Къде мога да намеря готови примери?
В Cookbook има копируеми промпти и примери за код; колекцията Postman съдържа същите крайни точки за директно тестване.
Следваща спирка
Какво следва
Препоръчителната следваща стъпка във фунията за разработчици и две подходящи разклонения.