SkillFoxx
Telegram

Скилл: основы REST API Битрикс24

bitrix24-rest-api

Claude Code skill с проверенными на живом портале нюансами REST API Битрикс24: авторизация, ошибки под HTTP 200, ретраи и лимиты

  • 0 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Минимальный доступ

Почему такой уровень

  • Только справочные знания для агента, сам код не выполняет запросов
Все причины и проверки
Российский стек

svjszn/bitrix24-api-skillАвтор:soajv

Установка

Сервисы

Ручная установка

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 из каталога скиллов агента.

Частые вопросы

Чем вебхук отличается от OAuth-приложения?

Вебхук проще и не требует переустановки токена, но не дает доступ к методам уровня приложения вроде imconnector.*, для них нужно локальное или маркетплейс-приложение.

Откуда взяты факты скилла?

Из официальной документации apidocs.bitrix24.com и проверки на реальном портале, а не только из документации.

Обсуждение

Вопросов и отзывов пока нет.

Битрикс24 — все инструменты
Российский стек

Скилл Битрикс24 REST с разбивкой по модулям, allowlist методов, подтверждением рискованных действий и аудит-логом

СкиллШирокий доступ26
Российский стек

Скилл для администрирования, диагностики и разработки коробочного Битрикс24 и Bitrix Framework по официальной документации

СкиллРасширенный доступ1
Официальный

Семь официальных скиллов Битрикс24 для JS/TS SDK: выбор B24Hook, B24Frame или B24OAuth, REST-вызовы, фильтры, iframe-менеджеры и 12 готовых мини-приложений

СкиллРасширенный доступ18
Официальный

Скилл официального PHP SDK Битрикс24: учит агента подключать вебхуки и OAuth, вызывать сервисы SDK и обрабатывать результаты, ошибки и пагинацию

СкиллРасширенный доступ103

Коротко о README

README объясняет, что это не клиентская библиотека, а файл знаний для ИИ-агента, и перечисляет, что покрыто: режимы авторизации, проверка тела ответа на ошибку даже при HTTP 200, непостоянная форма списков, политика ретраев, диагностика insufficient_scope, лимиты запросов, набор частых методов CRM и задач и связанный скилл для Open Lines.

Бейдж для README

Исходный 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.

Сообщить о проблеме