Разработка Битрикс-бота: история о том, как документация врала, а облака смеялись

[vacoo]

Подтверждаю. Битрикс это лютая дичь. Код очень низкого качества

[Pluzh]

В битриксе так устроено буквально всё, не только боты.

Их документация:
А) Разбросана как попало по множеству страниц.
Б) Неполная
В) Недостоверная, то есть часто там вообще описано что-то не то, что реально есть в битриксе.

Можно было бы применять вместо документации глаза и логику. Но элементы внутри самой системы:
А) Разбросаны внутри с грубыми нарушениями логики
Б) Не содержат функций, которые ожидаешь увидеть в любом интерфейсе.
В) Делают не то, что на них написано.
Г) Имеют незадокументированные исключения в применимости.
Д) Однотипные элементы работают по разной логике.
Обычная фильтрация может в одном месте действительно фильтровать, как ожидается, а в другом месте фильтровать, но совсем не так.

Я долго думал - действительно ли разработчики битрикс настолько плохи.
Но отгадку я услышал случайно на одной из их конференций с партнёрами-интеграторами. Они сказали, что и так дают тем заработать...

[serg-vostrikov]

Спасибо за статью! Разобраться с особенностями ботов - не самая простая история. Это достаточно старый функционал, который по мере развития, оброс рядом костылей в REST API, к сожалению. И пока мы еще не до конца актуализировали материалы по ботам в доке. Как раз в ближайших планах обновление по этому поводу от команды коммуникаций.

И да, текущая версия REST API - это зоопарк, получившийся в силу интенсивного наращивания пользовательского функционала, прежде всего. Битрикс24, признаем, не API first продукт. Но мы стараемся исправиться в новой версии REST API, которая уже жестко регламентирована для внутренней разработки. Думаю, скоро первые методы уже выкатим.

Было бы очень круто, если бы вы этот материал в виде туториала закинули в доку - https://github.com/bitrix-tools/b24-rest-docs. Уверен, что много людей были бы очень благодарны за подробный разбор особенностей bot api в Битрикс24 :).

[MrSotnik]

Отлично, появиться свободное время попробую туда изложить проблемные места и то как с этим можно и нужно бороться))

[Gosha04ye]

Пока дочитаешь до конца, уже забыл с чего начал. Половина советов норм, другая - будто для людей с тремя руками. Но да, пара идей реально может сэкономить нервы, особенно если раньше сам через всё это проходил.

[MrSotnik]

Ну это личный опыт, то с какими проблемами я столкнулся, но рад, что ты нашёл в статейке что-то полезное))

[babysas]

Не касаемо Битрикс апи, а в целом:
Про структуру запроса - обычно подобные косяки с добавлением информации по API POST/PUT и т.д.
- Если не получилось с копипэйста из документации, как правило имеет смысл GET и уже по полученной структуре разгребать.
- не редко всё настолько непонятно, что приходится заполнить все поля в UI сначала данными типа field_name и цифрами/датами остальное :))

- бывает нужна магия, например в Zoho CRM был глюк один их методов работал только со строчной переменной, хотя и в документации и в том, что приходило по GET был массив. Как я догадался? естественно случайно :)
- с другой стороны это то почему я не верю в скорую победу ИИ над кожанными мешками :)

[MrSotnik]

Понятно что глянуть через Get можно, даже есть такой запрос, но вот вопрос? А как узнать какие в этом загадочном API параметры на вход идут))