diff --git a/apps/docs/content/api/authorization.mdx b/apps/docs/content/api/authorization.mdx index 8c3ef205..726b3407 100644 --- a/apps/docs/content/api/authorization.mdx +++ b/apps/docs/content/api/authorization.mdx @@ -1,6 +1,6 @@ --- title: Авторизация -description: "Авторизация в API Пачки: персональный токен и токен бота, скоупы методов, настройка доступа для администраторов и сотрудников, смена владельца пространства" +description: "Авторизация в API Пачки: персональный токен и токен бота, скоупы методов, headless-интеграции для агентов, настройка доступа для администраторов и сотрудников, смена владельца пространства" related: - /api/requests-responses - /api/errors @@ -35,6 +35,16 @@ related: [Скоупы](#skoupy) определяют только **какие методы** можно вызывать — расширить круг данных за пределы границ типа токена они не могут. +### Какой токен выбрать + +Выберите тип по задаче, которую решает интеграция: + +| Задача | Тип токена | С чего начать | +| --- | --- | --- | +| Скрипт или утилита от вашего имени, личная автоматизация, разовая выгрузка данных | Персональный | [Создание персонального токена](#sozdanie-personalnogo-tokena) | +| Чат-бот, уведомления из внешних систем, обработка вебхуков, интерактивные формы | Бот | [Боты](/guides/bots/overview) | +| Агент или headless-интеграция без участия человека (CI, сервер, облачный воркер) | Бот | [Агенты и headless-интеграции](#agenty-i-headless-integratsii) | + ## Кто может создавать токены Владелец пространства может ограничить, кто может создавать токены и работать с API. Настройки находятся в разделе **Настройки пространства**: @@ -62,7 +72,12 @@ related: ## Получение токена бота -Бот виден в пространстве как отдельный участник со своим именем и аватаром. После создания бота его `access_token` доступен во вкладке **API** в настройках бота. Подробнее о создании и настройке бота — в разделе [Боты](/guides/bots/overview). +Бот виден в пространстве как отдельный участник со своим именем и аватаром. Получить его `access_token` можно двумя способами: + +- **В интерфейсе** — во вкладке **API** в настройках бота. +- **Через API** — методом [Новый бот](POST /bots): он создаёт бота и сразу возвращает `access_token`. Сохраните токен из ответа — повторно получить его можно только через интерфейс. + +Подробнее о создании и настройке бота — в разделе [Боты](/guides/bots/overview). ### Методы, требующие токен бота @@ -83,6 +98,12 @@ related: Authorization: Bearer ``` +## Агенты и headless-интеграции + +Агенту или автоматизации без участия человека (CI, сервер, облачный воркер) подходит токен бота — он работает как сервисная учётная запись, не привязанная к конкретному пользователю. Выдайте боту только нужные для задачи скоупы: принцип наименьших привилегий ограничивает круг доступных методов. + +Как подключить агента (CLI, llms.txt, Skills) — в разделе [AI-агенты](/guides/ai-agents/overview). Передача токена в headless-режиме (`PACHCA_TOKEN` из секретов) — в разделе [CLI: авторизация](/guides/cli/authentication#ci-i-agenty-headless). + ## Скоупы Скоупы определяют, к каким методам API имеет доступ токен. Разные типы токенов получают скоупы по-разному: diff --git a/apps/docs/content/guides/ai-agents/overview.mdx b/apps/docs/content/guides/ai-agents/overview.mdx index aa8f031a..5bcc4572 100644 --- a/apps/docs/content/guides/ai-agents/overview.mdx +++ b/apps/docs/content/guides/ai-agents/overview.mdx @@ -34,6 +34,8 @@ related: ## Как подключить Пачку к агенту +Чтобы агент выполнял действия в API, ему нужен токен. Агенту или автоматизации без участия человека подойдёт **токен бота** — сервисная учётная запись с минимальными скоупами (см. [Авторизация](/api/authorization)). В CI и headless-окружении передавайте токен переменной `PACHCA_TOKEN` из секретов — см. [CLI: авторизация](/guides/cli/authentication#ci-i-agenty-headless). + ### llms.txt Самый простой способ для разовых задач. Скопируйте ссылку в промпт агента — он получит сводку API со ссылками на документацию. Подходит, когда нужно быстро попросить агента сделать что-то конкретное в Пачке. diff --git a/apps/docs/content/guides/quickstart.mdx b/apps/docs/content/guides/quickstart.mdx index 5f452c40..c92d50e7 100644 --- a/apps/docs/content/guides/quickstart.mdx +++ b/apps/docs/content/guides/quickstart.mdx @@ -23,7 +23,7 @@ related: Для работы с API вам нужен токен доступа. Есть два способа его получить: - **Персональный токен** — в интерфейсе Пачки: **Автоматизации** > **API** (доступно администраторам) - - **Токен бота** — создайте бота в **Автоматизации** > **Интеграции** > **Чат-боты и Вебхуки** + - **Токен бота** — создайте бота в **Автоматизации** > **Интеграции** > **Чат-боты и Вебхуки** или программно методом [Новый бот](POST /bots) Подробнее о типах токенов и скоупах — в разделе [Авторизация](/api/authorization). diff --git a/apps/docs/public/api/authorization.md b/apps/docs/public/api/authorization.md index 34de51af..042bbdf1 100644 --- a/apps/docs/public/api/authorization.md +++ b/apps/docs/public/api/authorization.md @@ -1,5 +1,5 @@ > Расположение: Основы API -> Краткое содержание: Авторизация в API Пачки: персональный токен и токен бота, скоупы методов, настройка доступа для администраторов и сотрудников, смена владельца пространства +> Краткое содержание: Авторизация в API Пачки: персональный токен и токен бота, скоупы методов, headless-интеграции для агентов, настройка доступа для администраторов и сотрудников, смена владельца пространства > Это Markdown-версия конкретной страницы. Для контекста за её пределами (правила API, полный перечень методов, авторизация) ОБЯЗАТЕЛЬНО открой [llms.txt](https://dev.pachca.com/llms.txt) перед ответом — это сэкономит токены и предотвратит неполный ответ. @@ -29,6 +29,16 @@ > [Скоупы](#skoupy) определяют только **какие методы** можно вызывать — расширить круг данных за пределы границ типа токена они не могут. +### Какой токен выбрать + +Выберите тип по задаче, которую решает интеграция: + +| Задача | Тип токена | С чего начать | +| --- | --- | --- | +| Скрипт или утилита от вашего имени, личная автоматизация, разовая выгрузка данных | Персональный | [Создание персонального токена](#sozdanie-personalnogo-tokena) | +| Чат-бот, уведомления из внешних систем, обработка вебхуков, интерактивные формы | Бот | [Боты](/guides/bots/overview) | +| Агент или headless-интеграция без участия человека (CI, сервер, облачный воркер) | Бот | [Агенты и headless-интеграции](#agenty-i-headless-integratsii) | + ## Кто может создавать токены Владелец пространства может ограничить, кто может создавать токены и работать с API. Настройки находятся в разделе **Настройки пространства**: @@ -67,7 +77,12 @@ ## Получение токена бота -Бот виден в пространстве как отдельный участник со своим именем и аватаром. После создания бота его `access_token` доступен во вкладке **API** в настройках бота. Подробнее о создании и настройке бота — в разделе [Боты](/guides/bots/overview). +Бот виден в пространстве как отдельный участник со своим именем и аватаром. Получить его `access_token` можно двумя способами: + +- **В интерфейсе** — во вкладке **API** в настройках бота. +- **Через API** — методом [Новый бот](POST /bots): он создаёт бота и сразу возвращает `access_token`. Сохраните токен из ответа — повторно получить его можно только через интерфейс. + +Подробнее о создании и настройке бота — в разделе [Боты](/guides/bots/overview). ### Методы, требующие токен бота @@ -88,6 +103,12 @@ Authorization: Bearer ``` +## Агенты и headless-интеграции + +Агенту или автоматизации без участия человека (CI, сервер, облачный воркер) подходит токен бота — он работает как сервисная учётная запись, не привязанная к конкретному пользователю. Выдайте боту только нужные для задачи скоупы: принцип наименьших привилегий ограничивает круг доступных методов. + +Как подключить агента (CLI, llms.txt, Skills) — в разделе [AI-агенты](/guides/ai-agents/overview). Передача токена в headless-режиме (`PACHCA_TOKEN` из секретов) — в разделе [CLI: авторизация](/guides/cli/authentication#ci-i-agenty-headless). + ## Скоупы Скоупы определяют, к каким методам API имеет доступ токен. Разные типы токенов получают скоупы по-разному: diff --git a/apps/docs/public/api/llms.txt b/apps/docs/public/api/llms.txt index 68281c8e..b2c5f994 100644 --- a/apps/docs/public/api/llms.txt +++ b/apps/docs/public/api/llms.txt @@ -6,7 +6,7 @@ ## Основы API - [Обзор](https://dev.pachca.com/api/overview.md): Обзор REST API Пачки: базовый URL, авторизация по Bearer-токену, формат запросов и ответов, клиенты и SDK для CLI, TypeScript, Python, Go, Kotlin, Swift и C# -- [Авторизация](https://dev.pachca.com/api/authorization.md): Авторизация в API Пачки: персональный токен и токен бота, скоупы методов, настройка доступа для администраторов и сотрудников, смена владельца пространства +- [Авторизация](https://dev.pachca.com/api/authorization.md): Авторизация в API Пачки: персональный токен и токен бота, скоупы методов, headless-интеграции для агентов, настройка доступа для администраторов и сотрудников, смена владельца пространства - [Запросы и ответы](https://dev.pachca.com/api/requests-responses.md): Формат запросов и ответов API Пачки: базовый URL, заголовки Authorization и Content-Type, структура JSON-тела, коллекции Postman и Bruno для тестирования - [Пагинация](https://dev.pachca.com/api/pagination.md): Пагинация в API Пачки по курсору: две группы методов (списочные и поиск) с разной структурой meta, поля next_page, prev_page, has_next, has_prev, обход всех записей и polling новых данных через prev_page - [Загрузка файлов](https://dev.pachca.com/api/file-uploads.md): Трёхшаговая загрузка файлов в API Пачки через presigned URL S3: получение подписи, отправка multipart/form-data и прикрепление к сообщению или задаче diff --git a/apps/docs/public/guides/ai-agents/overview.md b/apps/docs/public/guides/ai-agents/overview.md index c00ce52a..48925352 100644 --- a/apps/docs/public/guides/ai-agents/overview.md +++ b/apps/docs/public/guides/ai-agents/overview.md @@ -29,6 +29,8 @@ ## Как подключить Пачку к агенту +Чтобы агент выполнял действия в API, ему нужен токен. Агенту или автоматизации без участия человека подойдёт **токен бота** — сервисная учётная запись с минимальными скоупами (см. [Авторизация](/api/authorization)). В CI и headless-окружении передавайте токен переменной `PACHCA_TOKEN` из секретов — см. [CLI: авторизация](/guides/cli/authentication#ci-i-agenty-headless). + ### llms.txt Самый простой способ для разовых задач. Скопируйте ссылку в промпт агента — он получит сводку API со ссылками на документацию. Подходит, когда нужно быстро попросить агента сделать что-то конкретное в Пачке. diff --git a/apps/docs/public/guides/quickstart.md b/apps/docs/public/guides/quickstart.md index f8c50cbb..f70fde93 100644 --- a/apps/docs/public/guides/quickstart.md +++ b/apps/docs/public/guides/quickstart.md @@ -17,7 +17,7 @@ Для работы с API вам нужен токен доступа. Есть два способа его получить: - **Персональный токен** — в интерфейсе Пачки: **Автоматизации** > **API** (доступно администраторам) -- **Токен бота** — создайте бота в **Автоматизации** > **Интеграции** > **Чат-боты и Вебхуки** +- **Токен бота** — создайте бота в **Автоматизации** > **Интеграции** > **Чат-боты и Вебхуки** или программно методом [Новый бот](POST /bots) > Подробнее о типах токенов и скоупах — в разделе [Авторизация](/api/authorization). diff --git a/apps/docs/public/llms-full.txt b/apps/docs/public/llms-full.txt index 0b7dfc2c..9c1b9702 100644 --- a/apps/docs/public/llms-full.txt +++ b/apps/docs/public/llms-full.txt @@ -16,83 +16,83 @@ |--------|--------| | LIBRARY RULES — правила: auth, пагинация, лимиты, ошибки, SDK | 97–199 | | How-to Guides — рецепты задач с кодом TS/Python | 200–883 | -| Руководства — гайды: SDK, вебхуки, боты, формы, n8n, CLI | 884–11447 | +| Руководства — гайды: SDK, вебхуки, боты, формы, n8n, CLI | 884–11470 | | · Обзор | 889–991 | | · Быстрый старт | 992–1081 | -| · AI агенты | 1082–1217 | -| · Взаимодействие с агентом | 1218–1286 | -| · Markdown и документы | 1287–1343 | -| · Треды | 1344–1471 | -| · Боты | 1472–1534 | -| · Создание и настройка | 1535–1661 | -| · Доступы к чатам и сообщениям | 1662–1734 | -| · Готовые примеры реализации | 1735–1769 | -| · Входящие вебхуки | 1770–1910 | -| · Исходящие вебхуки | 1911–1955 | -| · Настройка и типы событий | 1956–2137 | -| · Безопасность и обработчик | 2138–2328 | -| · Поллинг | 2329–2512 | -| · Кнопки в сообщениях | 2513–2668 | -| · Формы | 2669–2738 | -| · Блоки представления | 2739–2952 | -| · Обработка форм | 2953–3092 | -| · Разворачивание ссылок | 3093–3205 | -| · Экспорт сообщений | 3206–3347 | -| · DLP-система | 3348–3555 | -| · Пачка Audit Events API | 3556–3630 | -| · Форматирование текста | 3631–3711 | -| · Сценарии | 3712–4209 | -| · CLI | 4210–4303 | -| · Установка | 4304–4396 | -| · Авторизация | 4397–4470 | -| · Вывод | 4471–4574 | -| · Флаги и скрипты | 4575–4801 | -| · Сценарии | 4802–4849 | -| · Файлы | 4850–4884 | -| · Прямые запросы | 4885–4995 | -| · Команды | 4996–5133 | -| · SDK и генератор | 5134–5219 | -| · TypeScript | 5220–5637 | -| · Python | 5638–6049 | -| · Go | 6050–6486 | -| · Kotlin | 6487–6915 | -| · Swift | 6916–7313 | -| · C# | 7314–7772 | -| · n8n | 7773–7848 | -| · Начало работы | 7849–8076 | -| · Ресурсы и операции | 8077–8455 | -| · Триггер | 8456–8707 | -| · Тестирование | 8708–8981 | -| · Примеры workflow | 8982–9197 | -| · Продвинутые функции | 9198–9434 | -| · Устранение ошибок | 9435–9614 | -| · Миграция с v1 | 9615–9736 | -| · Последние обновления | 9737–9746 | -| · Обзор | 9747–9846 | -| · Авторизация | 9847–10029 | -| · Запросы и ответы | 10030–10220 | -| · Пагинация | 10221–10457 | -| · Загрузка файлов | 10458–10675 | -| · Ошибки | 10676–10749 | -| · Лимиты | 10750–10867 | -| · Модели | 10868–11447 | -| API-методы — все эндпоинты со схемами и примерами | 11448–27658 | -| · Common | 11450–12242 | -| · Profile | 12243–13244 | -| · Users | 13245–15624 | -| · Group tags | 15625–16972 | -| · Chats | 16973–18238 | -| · Members | 18239–19583 | -| · Threads | 19584–20141 | -| · Messages | 20142–22022 | -| · Read members | 22023–22269 | -| · Reactions | 22270–22916 | -| · Link Previews | 22917–23172 | -| · Search | 23173–23982 | -| · Tasks | 23983–25272 | -| · Views | 25273–25835 | -| · Bots | 25836–27346 | -| · Security | 27347–27658 | +| · AI агенты | 1082–1219 | +| · Взаимодействие с агентом | 1220–1288 | +| · Markdown и документы | 1289–1345 | +| · Треды | 1346–1473 | +| · Боты | 1474–1536 | +| · Создание и настройка | 1537–1663 | +| · Доступы к чатам и сообщениям | 1664–1736 | +| · Готовые примеры реализации | 1737–1771 | +| · Входящие вебхуки | 1772–1912 | +| · Исходящие вебхуки | 1913–1957 | +| · Настройка и типы событий | 1958–2139 | +| · Безопасность и обработчик | 2140–2330 | +| · Поллинг | 2331–2514 | +| · Кнопки в сообщениях | 2515–2670 | +| · Формы | 2671–2740 | +| · Блоки представления | 2741–2954 | +| · Обработка форм | 2955–3094 | +| · Разворачивание ссылок | 3095–3207 | +| · Экспорт сообщений | 3208–3349 | +| · DLP-система | 3350–3557 | +| · Пачка Audit Events API | 3558–3632 | +| · Форматирование текста | 3633–3713 | +| · Сценарии | 3714–4211 | +| · CLI | 4212–4305 | +| · Установка | 4306–4398 | +| · Авторизация | 4399–4472 | +| · Вывод | 4473–4576 | +| · Флаги и скрипты | 4577–4803 | +| · Сценарии | 4804–4851 | +| · Файлы | 4852–4886 | +| · Прямые запросы | 4887–4997 | +| · Команды | 4998–5135 | +| · SDK и генератор | 5136–5221 | +| · TypeScript | 5222–5639 | +| · Python | 5640–6051 | +| · Go | 6052–6488 | +| · Kotlin | 6489–6917 | +| · Swift | 6918–7315 | +| · C# | 7316–7774 | +| · n8n | 7775–7850 | +| · Начало работы | 7851–8078 | +| · Ресурсы и операции | 8079–8457 | +| · Триггер | 8458–8709 | +| · Тестирование | 8710–8983 | +| · Примеры workflow | 8984–9199 | +| · Продвинутые функции | 9200–9436 | +| · Устранение ошибок | 9437–9616 | +| · Миграция с v1 | 9617–9738 | +| · Последние обновления | 9739–9748 | +| · Обзор | 9749–9848 | +| · Авторизация | 9849–10052 | +| · Запросы и ответы | 10053–10243 | +| · Пагинация | 10244–10480 | +| · Загрузка файлов | 10481–10698 | +| · Ошибки | 10699–10772 | +| · Лимиты | 10773–10890 | +| · Модели | 10891–11470 | +| API-методы — все эндпоинты со схемами и примерами | 11471–27681 | +| · Common | 11473–12265 | +| · Profile | 12266–13267 | +| · Users | 13268–15647 | +| · Group tags | 15648–16995 | +| · Chats | 16996–18261 | +| · Members | 18262–19606 | +| · Threads | 19607–20164 | +| · Messages | 20165–22045 | +| · Read members | 22046–22292 | +| · Reactions | 22293–22939 | +| · Link Previews | 22940–23195 | +| · Search | 23196–24005 | +| · Tasks | 24006–25295 | +| · Views | 25296–25858 | +| · Bots | 25859–27369 | +| · Security | 27370–27681 | # LIBRARY RULES @@ -1004,7 +1004,7 @@ curl "https://api.pachca.com/api/shared/v1/messages" \ Для работы с API вам нужен токен доступа. Есть два способа его получить: - **Персональный токен** — в интерфейсе Пачки: **Автоматизации** > **API** (доступно администраторам) -- **Токен бота** — создайте бота в **Автоматизации** > **Интеграции** > **Чат-боты и Вебхуки** +- **Токен бота** — создайте бота в **Автоматизации** > **Интеграции** > **Чат-боты и Вебхуки** или программно методом [Новый бот](POST /bots) > Подробнее о типах токенов и скоупах — в разделе [Авторизация](/api/authorization). @@ -1105,6 +1105,8 @@ curl "https://api.pachca.com/api/shared/v1/chats" \ ## Как подключить Пачку к агенту +Чтобы агент выполнял действия в API, ему нужен токен. Агенту или автоматизации без участия человека подойдёт **токен бота** — сервисная учётная запись с минимальными скоупами (см. [Авторизация](/api/authorization)). В CI и headless-окружении передавайте токен переменной `PACHCA_TOKEN` из секретов — см. [CLI: авторизация](/guides/cli/authentication#ci-i-agenty-headless). + ### llms.txt Самый простой способ для разовых задач. Скопируйте ссылку в промпт агента — он получит сводку API со ссылками на документацию. Подходит, когда нужно быстро попросить агента сделать что-то конкретное в Пачке. @@ -9870,6 +9872,16 @@ dotnet add package Pachca.Sdk > [Скоупы](#skoupy) определяют только **какие методы** можно вызывать — расширить круг данных за пределы границ типа токена они не могут. +### Какой токен выбрать + +Выберите тип по задаче, которую решает интеграция: + +| Задача | Тип токена | С чего начать | +| --- | --- | --- | +| Скрипт или утилита от вашего имени, личная автоматизация, разовая выгрузка данных | Персональный | [Создание персонального токена](#sozdanie-personalnogo-tokena) | +| Чат-бот, уведомления из внешних систем, обработка вебхуков, интерактивные формы | Бот | [Боты](/guides/bots/overview) | +| Агент или headless-интеграция без участия человека (CI, сервер, облачный воркер) | Бот | [Агенты и headless-интеграции](#agenty-i-headless-integratsii) | + ## Кто может создавать токены Владелец пространства может ограничить, кто может создавать токены и работать с API. Настройки находятся в разделе **Настройки пространства**: @@ -9908,7 +9920,12 @@ dotnet add package Pachca.Sdk ## Получение токена бота -Бот виден в пространстве как отдельный участник со своим именем и аватаром. После создания бота его `access_token` доступен во вкладке **API** в настройках бота. Подробнее о создании и настройке бота — в разделе [Боты](/guides/bots/overview). +Бот виден в пространстве как отдельный участник со своим именем и аватаром. Получить его `access_token` можно двумя способами: + +- **В интерфейсе** — во вкладке **API** в настройках бота. +- **Через API** — методом [Новый бот](POST /bots): он создаёт бота и сразу возвращает `access_token`. Сохраните токен из ответа — повторно получить его можно только через интерфейс. + +Подробнее о создании и настройке бота — в разделе [Боты](/guides/bots/overview). ### Методы, требующие токен бота @@ -9929,6 +9946,12 @@ dotnet add package Pachca.Sdk Authorization: Bearer ``` +## Агенты и headless-интеграции + +Агенту или автоматизации без участия человека (CI, сервер, облачный воркер) подходит токен бота — он работает как сервисная учётная запись, не привязанная к конкретному пользователю. Выдайте боту только нужные для задачи скоупы: принцип наименьших привилегий ограничивает круг доступных методов. + +Как подключить агента (CLI, llms.txt, Skills) — в разделе [AI-агенты](/guides/ai-agents/overview). Передача токена в headless-режиме (`PACHCA_TOKEN` из секретов) — в разделе [CLI: авторизация](/guides/cli/authentication#ci-i-agenty-headless). + ## Скоупы Скоупы определяют, к каким методам API имеет доступ токен. Разные типы токенов получают скоупы по-разному: diff --git a/apps/docs/public/llms.txt b/apps/docs/public/llms.txt index 2c4dd6fc..09509637 100644 --- a/apps/docs/public/llms.txt +++ b/apps/docs/public/llms.txt @@ -178,7 +178,7 @@ C#: new PachcaClient("TOKEN") → await client.Messages.CreateMessage - [n8n, Миграция с v1](https://dev.pachca.com/guides/n8n/migration.md): Обновление расширения Пачки для n8n с v1 на v2: таблицы переименований, новые возможности и полная обратная совместимость для существующих workflow - [Последние обновления](https://dev.pachca.com/updates.md): История изменений API Пачки, CLI, SDK и расширения для n8n. Новые методы, параметры и возможности. RSS-лента и markdown-версия для AI-агентов и интеграций - [Основы API, Обзор](https://dev.pachca.com/api/overview.md): Обзор REST API Пачки: базовый URL, авторизация по Bearer-токену, формат запросов и ответов, клиенты и SDK для CLI, TypeScript, Python, Go, Kotlin, Swift и C# -- [Основы API, Авторизация](https://dev.pachca.com/api/authorization.md): Авторизация в API Пачки: персональный токен и токен бота, скоупы методов, настройка доступа для администраторов и сотрудников, смена владельца пространства +- [Основы API, Авторизация](https://dev.pachca.com/api/authorization.md): Авторизация в API Пачки: персональный токен и токен бота, скоупы методов, headless-интеграции для агентов, настройка доступа для администраторов и сотрудников, смена владельца пространства - [Основы API, Запросы и ответы](https://dev.pachca.com/api/requests-responses.md): Формат запросов и ответов API Пачки: базовый URL, заголовки Authorization и Content-Type, структура JSON-тела, коллекции Postman и Bruno для тестирования - [Основы API, Пагинация](https://dev.pachca.com/api/pagination.md): Пагинация в API Пачки по курсору: две группы методов (списочные и поиск) с разной структурой meta, поля next_page, prev_page, has_next, has_prev, обход всех записей и polling новых данных через prev_page - [Основы API, Загрузка файлов](https://dev.pachca.com/api/file-uploads.md): Трёхшаговая загрузка файлов в API Пачки через presigned URL S3: получение подписи, отправка multipart/form-data и прикрепление к сообщению или задаче diff --git a/apps/docs/public/skill.md b/apps/docs/public/skill.md index 3e1b729f..a8e325d6 100644 --- a/apps/docs/public/skill.md +++ b/apps/docs/public/skill.md @@ -279,7 +279,7 @@ Detailed documentation on specific topics is available at: - [n8n, Миграция с v1](https://dev.pachca.com/guides/n8n/migration) — Обновление расширения Пачки для n8n с v1 на v2: таблицы переименований, новые возможности и полная обратная совместимость для существующих workflow - [Последние обновления](https://dev.pachca.com/updates) — История изменений API Пачки, CLI, SDK и расширения для n8n. Новые методы, параметры и возможности. RSS-лента и markdown-версия для AI-агентов и интеграций - [Основы API, Обзор](https://dev.pachca.com/api/overview) — Обзор REST API Пачки: базовый URL, авторизация по Bearer-токену, формат запросов и ответов, клиенты и SDK для CLI, TypeScript, Python, Go, Kotlin, Swift и C# -- [Основы API, Авторизация](https://dev.pachca.com/api/authorization) — Авторизация в API Пачки: персональный токен и токен бота, скоупы методов, настройка доступа для администраторов и сотрудников, смена владельца пространства +- [Основы API, Авторизация](https://dev.pachca.com/api/authorization) — Авторизация в API Пачки: персональный токен и токен бота, скоупы методов, headless-интеграции для агентов, настройка доступа для администраторов и сотрудников, смена владельца пространства - [Основы API, Запросы и ответы](https://dev.pachca.com/api/requests-responses) — Формат запросов и ответов API Пачки: базовый URL, заголовки Authorization и Content-Type, структура JSON-тела, коллекции Postman и Bruno для тестирования - [Основы API, Пагинация](https://dev.pachca.com/api/pagination) — Пагинация в API Пачки по курсору: две группы методов (списочные и поиск) с разной структурой meta, поля next_page, prev_page, has_next, has_prev, обход всех записей и polling новых данных через prev_page - [Основы API, Загрузка файлов](https://dev.pachca.com/api/file-uploads) — Трёхшаговая загрузка файлов в API Пачки через presigned URL S3: получение подписи, отправка multipart/form-data и прикрепление к сообщению или задаче