SkillFoxx
Telegram

Скилл разработчика Bitrix24 PHP SDK

Bitrix24 PHP SDK

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

  • 103 ★ репозитория
  • Последний коммит
  • MIT
СкиллОфициальныйВыбор редакции

Расширенный доступ

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

  • Сгенерированный код обращается к боевому порталу Битрикс24 через вебхук или OAuth
  • Неверная обработка секретов вебхука или токенов OAuth может раскрыть доступ к порталу
Все причины и проверки
Российский стек

bitrix24/b24phpsdkАвтор:Bitrix24

Установка

Сервисы

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/bitrix24-php-sdk

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Сгенерированный код обращается к боевому порталу Битрикс24 через вебхук или OAuth
  • Неверная обработка секретов вебхука или токенов OAuth может раскрыть доступ к порталу

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл b24phpsdk-developer лежит в самом репозитории SDK по пути resources/skills и предназначен для продуктовых приложений, которые используют bitrix24/b24phpsdk, а не для разработки самого SDK. Он задает порядок работы: сначала посмотреть установленную версию и сервисы через ServiceBuilderFactory, выбрать вебхук для серверной интеграции с фиксированным порталом или OAuth, если приложение само устанавливается в разные порталы, хранить секреты только в конфигурации, ловить исключения SDK на границе приложения и работать с результатами и пагинацией через методы SDK, а не через сырой массив ответа. Отдельные справочные файлы разбирают установку, работу с результатами и обработку ошибок с тестами.

Для кого. Для PHP-разработчиков, которые пишут интеграции с Битрикс24 через официальный SDK и хотят, чтобы агент писал код по канону проекта.

Подходит, если

  • Пишете PHP-код, который вызывает сервисы bitrix24/b24phpsdk
  • Нужно правильно инициализировать доступ через вебхук или OAuth
  • Нужна выработанная практика обработки исключений, пагинации и batch-вызовов SDK

Не подходит, если

  • Работаете над самим репозиторием SDK: issue, релизы, генерация сервисов и покрытие OpenAPI, для этого в репозитории есть отдельный скилл b24phpsdk-maintainer
  • Нужен SDK для другого языка, не PHP

Пример запроса к агенту

Напиши сервис, который получает последние контакты Битрикс24 через b24phpsdk по вебхуку и оборачивает ошибки SDK

Ограничения

Скилл нужно вручную скопировать в свой проект, готовой команды установки в README нет. Требует уже установленный через Composer bitrix24/b24phpsdk. Библиотека существует в двух несовместимых версиях, v1 на ветке main и v3 на ветке v3 с другим форматом REST-эндпоинта, скилл не выбирает версию за вас.

Как отключить. Удалите папку b24phpsdk-developer из .claude/skills вашего проекта или .agents/skills, если использовали общий формат.

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

Чем этот скилл отличается от b24phpsdk-maintainer в том же репозитории?

b24phpsdk-developer предназначен для кода, который использует SDK в своем приложении, а b24phpsdk-maintainer только для работы над самим репозиторием SDK: issue, релизы, генерация сервисов.

Webhook или OAuth?

Скилл советует вебхук для серверных интеграций с фиксированным порталом и OAuth только когда приложение само владеет установкой в Битрикс24 и хранением токенов.

Обсуждение

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

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

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

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

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

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

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

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

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

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

Коротко о README

Файл SKILL.md описывает границу применения скилла, семишаговый порядок работы с SDK и таблицу маршрутизации к трем справочным файлам: установка и инициализация, работа с результатами и пагинацией, обработка ошибок и тесты. Отдельно показан паттерн адаптера, который отделяет доменный код от сервисов SDK через интерфейс продукта.

Бейдж для README

Исходный SKILL.md

---
name: b24phpsdk-developer
description: Use when writing product application code with bitrix24/b24phpsdk, integrating Bitrix24 webhooks or OAuth, choosing SDK service calls, handling SDK results, errors, pagination, batch calls, or tests outside the SDK repository
---

# Bitrix24 PHP SDK Developer

## Scope

Use this skill for product applications that consume `bitrix24/b24phpsdk`.

Do not use it for SDK repository maintenance: GitHub issue triage, release work, changelog policy,
OpenAPI coverage, generated SDK service wrappers, result-item annotation tests, or other SDK
internals. In the SDK repository, those tasks belong to `b24phpsdk-maintainer`.

## Workflow

1. Inspect the installed package version and public API first: read `composer.lock`, run
   `composer show bitrix24/b24phpsdk`, and search `vendor/bitrix24/b24phpsdk/src/Services` before
   writing integration code.
2. Prefer `ServiceBuilderFactory` and public service builders over direct REST calls.
3. Use incoming webhook initialization for server-side integrations that can rely on a fixed portal
   webhook. Use OAuth only when the product owns Bitrix24 app installation, token storage, and token
   refresh.
4. Keep webhook URLs, OAuth tokens, client secrets, and portal domains in environment or application
   configuration. Never inline them in code, docs, test fixtures, or logs.
5. Catch SDK exceptions at the application boundary. Do not scatter low-level SDK error handling
   through domain code.
6. Prefer SDK result objects and accessors such as `getContacts()` over raw response-array indexing.
7. Treat list calls as paginated. Use batch helpers deliberately when reading many records.
8. Test product logic with fakes around your own SDK boundary. Keep live Bitrix24 checks explicit,
   opt-in, and driven by `BITRIX24_WEBHOOK`.

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