Рабочий код и практика по теме — разборы, инструкции и кейсы для интеграции BOTIX.
Breaking change vs minor в публичном API, генерация трёх SDK из openapi.yaml и open-source как канал доверия — как обновлять SDK, не ломая интеграторов.
OAuth против API-ключа, Partner API с sub-проектами, изоляция project_id и open-source SDK — три свойства, которые делают из публичного API платформу.
Что превращает API в платформу для интеграторов: multi-tenant с изоляцией project_id, white-label через OAuth и open-source SDK. Разбор на реальном API BOTIX.
Год от внутреннего API до платформы: ручные SDK и три вида drift, переход на openapi-generator-cli, white-label через /partner/v1/*, open-source с MIT.
Zero-dependency SDK, открытый код на GitHub и партнёрский слой — три инженерных решения, которые превращают публичный API в платформу для интеграторов.