Перейти к содержимому
Разделы документации

Документация / Справочник

ИИ и инструменты

Промпт для ИИ, llms.txt, OpenAPI-спека и генерация SDK

Интеграция с помощью ИИ

Если интеграцию пишет Cursor, Claude, ChatGPT или другой ИИ-инструмент, не заставляйте его ходить по страницам: скопируйте готовый промпт - в нём инструкция и вся документация API одним текстом. Впишите свой стек в отмеченное место и отправьте агенту.

llms.txt

Для инструментов, которые умеют читать документацию сами, действует стандарт llms.txt:

  • tabpay.org/llms.txt - оглавление со ссылками;
  • tabpay.org/llms-full.txt - вся документация одним Markdown-файлом: контракты, подпись вебхука с кодом, статусы, ошибки, чек-лист интеграции.

Дайте агенту ссылку на llms-full.txt - и ему хватит одного запроса, чтобы узнать про API всё.

OpenAPI-спецификация

Машиночитаемый контракт API - tabpay.org/openapi.json (OpenAPI 3.1, включая описание вебхука и подписи). Что с ней можно сделать:

  • импортировать в Postman или Insomnia - получите готовую коллекцию запросов;
  • сгенерировать типизированный клиент под свой язык;
  • передать ИИ-агенту вместе с llms-full.txt.
# Типизированный клиент из OpenAPI-спецификации (openapi-typescript)
npx openapi-typescript https://tabpay.org/openapi.json -o tabpay-schema.ts

Официальных SDK пока нет сознательно: API компактное, а сгенерированный из спецификации клиент всегда совпадает с боевым контрактом.