Рабочий код и практика по теме — разборы, инструкции и кейсы для интеграции BOTIX.
Разбор: OpenAPI как единый источник правды против documentation/type/coverage drift, изоляция project_id для партнёрских ключей и минимальный Partner API.
Первый день с публичным API BOTIX: quickstart за 5 минут, где хранить ключ (7 антипаттернов) и журнал запросов в кабинете для отладки без тикетов.
Первая интеграция BOTIX заняла 38 минут, стала 4-7. Три решения DX: quickstart-артефакт, триал на проде вместо sandbox, партнёрские sub-проекты.
Первый день с Public API: что обязательно в quickstart, зачем триал вместо sandbox и как хранить ключ. Код, SQL, коды ошибок, чек-лист код-ревью.
Три решения BOTIX по developer experience: quickstart как отдельный жанр, триал вместо песочницы на проде, polling как честный fallback к webhook. С кодом.
Developer experience публичного API BOTIX: quickstart с ключом на странице, триал вместо sandbox-контура, webhook-симулятор. Код, таблицы, провалы.
Путь до первого JSON-ответа API BOTIX за 5 минут: developer-триал без мастера, ключ из quickstart, GET /me, SDK из OpenAPI 3.0 и триал вместо sandbox.
Как подключить SDK BOTIX без транзитивных зависимостей (PHP, Python, Node), хранить API-ключ через ENV и secret manager и зачем SDK открыты. Код и антипаттерны.
Как мы собрали три SDK (PHP/Python/Node) без единой зависимости, зачем построили webhook.botix.pro и почему выложили код в open-source на GitHub. Кейс.
Публичный SDK с 14 зависимостями = техдолг интегратора. Zero-deps, генерация из openapi.yaml, open-source SDK как канал доверия — как это сделано в BOTIX.
SDK BOTIX 1.1 (PHP, Python, Node): ноль зависимостей, генерация из openapi.yaml, триал вместо sandbox. Что изменилось и как мигрировать с 1.0.
