POST AI agent ready /v1/paste/get

API вставки извлечения — получение бесплатного фрагмента текста

Отправьте идентификатор вставки и получите сохраненный контент вместе с его языковым тегом и меткой времени создания. Возвращает 404, если срок действия пасты истек или она не существует. Используется в сочетании с конечной точкой /v1/paste/create.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/paste/get \
  -H "Content-Type: application/json" \
  -d '{"id":"f9e8d7c6"}'

When to use this API

Отображение общих фрагментов кода с подсветкой синтаксиса в вашем приложении.

Вставьте содержимое и языковой тег, а затем отобразите его с помощью средства выделения на стороне клиента, такого как Prism или Shiki. Тег языка сообщает маркеру, какую грамматику следует применить.

Извлеките данные конфигурации в сценарий развертывания.

Сохраните конфигурацию развертывания в виде вставки, а затем извлеките ее по идентификатору в свой скрипт. Это позволяет избежать жесткого кодирования конфигурации в вашем репозитории, сохраняя при этом ее доступность на протяжении всего окна развертывания.

Создайте страницу «Просмотр общего фрагмента» для вашего инструмента разработчика.

Когда пользователь делится ссылкой для вставки, извлекайте контент через эту конечную точку и визуализируйте его в средстве просмотра форматированного кода. Показать язык, время создания и кнопку копирования.

Frequently asked questions

Что произойдет, если срок годности пасты истек?

API возвращает ошибку 404 с кодом NOT_FOUND и сообщение о том, что вставка не найдена или срок ее действия истек.

Может ли кто-нибудь получить пасту, если у него есть идентификатор?

Да. Контроль доступа к отдельным пастам отсутствует. Любой, у кого есть 8-значный идентификатор, может получить контент. Не храните конфиденциальные данные в виде вставок, не зашифровав их предварительно.

Увеличивает ли извлечение пасты ее TTL?

Нет. Срок жизни устанавливается во время создания и не изменяется. Чтение пасты никак не влияет на срок ее годности.

Идентификатор вставки передается в URL-адресе или в теле запроса?

Идентификатор вставки передается в теле запроса JSON как поле «id». Путь к конечной точке всегда /v1/paste/get.

Могу ли я получить несколько вставок за один запрос?

Нет. Каждый запрос извлекает одну пасту. Чтобы получить несколько вставок, выполните параллельные запросы с разными идентификаторами.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.