llms.txt |
Два пътя, един API. Постави нашия llms.txt в Cursor, Claude Code или ChatGPT — или строй реални приложения в браузъра с Publishable Keys. Без SDK, без бекенд, без CORS ад.
Копирай. Постави. Ship.
Постави llms.txt в Cursor, Claude Code, Windsurf или ChatGPT — AI пише работещи интеграции.
AI-Canvas приложения с реални API повиквания.
Строй React приложения в един файл, които извикват нашия API директно от браузъра — в Claude Artifacts, ChatGPT Canvas, Gemini или Grok. Publishable Keys (po_pk_) в стил Stripe — scope-ограничени, budget-capped, origin-заключени.
Доверието на водещи компании по целия свят
Направено за AI — не за Postman.
Postman Collection е 1,5 MB JSON, оптимизиран за Postman/Insomnia/Bruno. llms.txt е чист Markdown.
Postman колекция
~1.5 MBИмпорт в Postman, Insomnia, Bruno — клик-тест, debug, споделяне в екип.
Към Postman →llms.txt (Hub)
~53 KBКомпактен индекс — за поставяне в AI за бързи lookup-и.
llms.txt →llms-full.txt
~780 KBВсеки endpoint с параметри, примерни отговори и error codes.
llms-full.txt →Примерни prompt-и
Тези prompt-и работят в Claude, Cursor, Windsurf, ChatGPT, Gemini и всеки друг coding AI.
Прочетете тази API документация:
[internal-endpoint] Python функция, която приема PDF файл и връща извлечения OCR текст.@Docs [internal-endpoint] FastAPI крайна точка, която класифицира качени фактури с помощта на /documentai/classify.You have access to the PaperOffice API. The full spec is at:
https://api.paperoffice.ai/latest/docs/llms-full.txt
Use a Bearer token in the Authorization header.Всеки AI говори llms.txt.
Markdown е роден език на модерните LLM. Хвърли URL-а в произволен инструмент.
Не е нужно доверие — правилата са в бетон.
Publishable Keys остават сигурни дори ако някой ги копира от кода на твоя AI-canvas artifact.
Опасни endpoint-и блокирани
DELETE, admin, billing, webhooks, token-management — hardcoded блокирани.
Бюджет cap мигновено
При достигане на лимита: HTTP 402 BUDGET_EXHAUSTED.
Rate-limiting през Redis
Sliding-window на токен. Превишение → HTTP 429.
Origin header задължителен
Браузърът го задава автоматично. Поради това злоупотреба от сървър към сървър с изтекъл po_pk_ е невъзможна.
Моментален revoke
Клик "Revoke" — Redis cache invalidate веднага. Компрометиран ключ мъртъв за милисекунди.
Гранулни scope
Всеки scope се включва/изключва индивидуално в dashboard.
От нула до работещ код за 30 секунди
Копирай URL-а
Вземи llms-full.txt за пълна spec или llms.txt за тесен индекс.
Постави в твоя AI
Claude дърпа URL-и автоматично. Cursor има @Docs. ChatGPT browse-ва.
Prompt и ship
AI разбира всеки endpoint, auth, pricing и error code.
ReadyВсичко, което трябва да знаеш за Publishable Keys.
Работи ли наистина само в Claude Artifacts?
Не — po_pk_ работи във всяка модерна AI-Canvas платформа: Claude Artifacts, ChatGPT Canvas, Gemini (Canvas & Gems), Grok Workspaces и browser-hosted среди като v0.dev, Bolt.new, StackBlitz или CodeSandbox.
По какво се различава po_pk_ от po_sk_?
po_sk_ (Secret Key) е предназначен за интеграция сървър към сървър — пълен достъп до целия API, никога не го поставяйте в браузъра. po_pk_ (Publishable Key) е създаден за браузърен код: ограничен по обхват до изрично разрешени групи крайни точки, с лимит на кредити за целия срок и заключване по произход. Един po_sk_ в AI-canvas артефакт би бил пълна катастрофа — po_pk_ по дизайн е ограничен до очакваните щети.
Какво става ако моят po_pk_ стане публичен?
Щетите остават ограничени: origin-lock, budget-cap, rate-limiting. "Revoke" убива ключа за милисекунди.
Мога ли да задавам собствени origin-и, напр. moja-firma.bg?
Да. Preset WIDGET е създаден точно за това.
Как задавам бюджета за кредити?
При създаване избираш доживотен лимит (default 1 000, AIDEMO 2 000, WIDGET 5 000).
Таксува ли се po_pk_ различно от po_sk_?
Не. Всеки API повик използва едни и същи кредити от основния ви акаунт — независимо дали е чрез po_sk_, po_ut_ или po_pk_. Лимитът на бюджета за po_pk_ е допълнителна предпазна мярка, а не отделно ценово ниво.
Кои endpoint-и са забранени за po_pk_?
Всички DELETE методи и всяка крайна точка за админ, таксуване, уебхук и управление на токени са твърдо блокирани — независимо какво изберете в обхвата. Поради това е технически невъзможно да се изтрият данни, да се прочете информация за таксуване или да се създават нови токени с po_pk_.
По-малко токени, по-евтини prompt-и, без JSON boilerplate.
Готов за prompt?
Copy, paste, ship — в твоя IDE или директно в браузъра. Два пътя, един API, без lock-in.