Скилл: основы REST API Битрикс24
bitrix24-rest-api
Claude Code skill с проверенными на живом портале нюансами REST API Битрикс24: авторизация, ошибки под HTTP 200, ретраи и лимиты
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только справочные знания для агента, сам код не выполняет запросов
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/bitrix24-rest-apiОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале в папке проекта
npx skills add soajv/bitrix24-api-skill --skill bitrix24-rest-api -a claude-code -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 0ae5aa0
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .claude/skills
cp -R "$tmp/skills/bitrix24-rest-api" .claude/skills/bitrix24-rest-apiКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add soajv/bitrix24-api-skill --skill bitrix24-rest-api -a cursor -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 0ae5aa0
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-rest-api" .agents/skills/bitrix24-rest-apiКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add soajv/bitrix24-api-skill --skill bitrix24-rest-api -a github-copilot -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 0ae5aa0
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .github/skills
cp -R "$tmp/skills/bitrix24-rest-api" .github/skills/bitrix24-rest-apiКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add soajv/bitrix24-api-skill --skill bitrix24-rest-api -a codex -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 0ae5aa0
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-rest-api" .agents/skills/bitrix24-rest-apiКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add soajv/bitrix24-api-skill --skill bitrix24-rest-api -a gemini-cli -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 0ae5aa0
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-rest-api" .agents/skills/bitrix24-rest-apiКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .devin/skills
cp -R "$tmp/skills/bitrix24-rest-api" .devin/skills/bitrix24-rest-apiКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Бывший Windsurf.
Выполните в терминале в папке проекта
npx skills add soajv/bitrix24-api-skill --skill bitrix24-rest-api -a cline -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 0ae5aa0
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .cline/skills
cp -R "$tmp/skills/bitrix24-rest-api" .cline/skills/bitrix24-rest-apiКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add soajv/bitrix24-api-skill --skill bitrix24-rest-api -a roo -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 0ae5aa0
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .roo/skills
cp -R "$tmp/skills/bitrix24-rest-api" .roo/skills/bitrix24-rest-apiКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Форк Roo Code, папки .roo те же.
Выполните в терминале в папке проекта
npx skills add soajv/bitrix24-api-skill --skill bitrix24-rest-api -a opencode -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 0ae5aa0
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-rest-api" .agents/skills/bitrix24-rest-apiКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-rest-api" .agents/skills/bitrix24-rest-apiКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-rest-api" .agents/skills/bitrix24-rest-apiКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Скопируй или подключи символьной ссылкой папку skills/bitrix24-rest-api из soajv/bitrix24-api-skill в каталог скиллов Claude Code и загружай ее перед написанием или отладкой интеграции с Битрикс24.
Другие способы из описания автора
git clone https://github.com/soajv/bitrix24-api-skill.git && cp -r bitrix24-api-skill/skills/bitrix24-rest-api ~/.claude/skills/Скопируйте папку скилла в каталог скиллов Claude Code.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл загружает в контекст агента перед написанием или отладкой интеграции с Битрикс24 набор проверенных фактов об API: разницу между входящим вебхуком и OAuth-приложением, предупреждение, что ошибка может прийти с HTTP 200 и ее нужно доставать из тела ответа, непостоянную форму ответа у методов списков, безопасную политику ретраев для сетевых ошибок и 429/503 и лимиты по принципу дырявого ведра. Отдельно разобран формат события ONAPPINSTALL с вложенными полями auth и одна задокументированная особенность Битрикса, когда автоконвертация лида молча отвязывает сделку.
Для кого. Для разработчиков, которые пишут или отлаживают интеграцию с REST API Битрикс24 через ИИ-агента.
Подходит, если
- Пишете клиент к Битрикс24 REST API с нуля
- Отлаживаете странности вроде HTTP 200 с ошибкой в теле
- Настраиваете ретраи и обработку лимитов запросов
Не подходит, если
- Нужна готовая клиентская библиотека, а не справочные знания
- Работаете с Open Lines и чат-ботами: для этого есть отдельный связанный скилл
Пример запроса к агенту
Напиши клиент для Битрикс24 REST API с ретраями и правильной проверкой ошибок в ответеОграничения
Это не библиотека кода, а файл знаний SKILL.md для агента, конкретных примеров интеграции в репозитории нет. Факты датированы сентябрем 2026 года и могут устареть при изменениях API. Автор один, звезд и лицензии, кроме MIT, отдельно не отмечено.
Как отключить. Удалите папку skills/bitrix24-rest-api из каталога скиллов агента.
Проверка безопасности
- Только справочные знания для агента, сам код не выполняет запросов
Коротко о README
README объясняет, что это не клиентская библиотека, а файл знаний для ИИ-агента, и перечисляет, что покрыто: режимы авторизации, проверка тела ответа на ошибку даже при HTTP 200, непостоянная форма списков, политика ретраев, диагностика insufficient_scope, лимиты запросов, набор частых методов CRM и задач и связанный скилл для Open Lines.
SKILL.md
--- name: bitrix24-rest-api description: Foundational knowledge for calling the Bitrix24 REST API from a backend service — auth modes (inbound webhook vs OAuth app), the "200 OK with error body" gotcha, list-endpoint response shapes, retry policy, and rate limits. Load this before writing any Bitrix24 API client code. --- # Bitrix24 REST API — foundations Source: official docs at apidocs.bitrix24.com (verified Sep 2026) plus empirical testing against a real Bitrix24 portal and a proven client pattern running in production integrations. ## Two ways to authenticate 1. Inbound webhook — https://<portal>.bitrix24.ru/rest/<user>/<token>/<method>.json. A portal admin creates it once, picking which method scopes it can call. No OAuth flow, no token refresh. This is enough for most bot and Open Lines session methods as long as the webhook has the right permissions checked. 2. OAuth local/marketplace app — install flow, token refresh via oauth.bitrix24.tech. Needed for app-level methods not exposed to webhooks, such as the whole imconnector.* family.
Частые вопросы
Чем вебхук отличается от OAuth-приложения?
Вебхук проще и не требует переустановки токена, но не дает доступ к методам уровня приложения вроде imconnector.*, для них нужно локальное или маркетплейс-приложение.
Откуда взяты факты скилла?
Из официальной документации apidocs.bitrix24.com и проверки на реальном портале, а не только из документации.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything