API, SDK и yCode
REST, SDK, webhooks, MCP и инструменты разработки.
Версионированные контракты
Разрешённые интеграции используют версионированные API и SDK Yasnora. Передавайте идентификацию и контекст политики; запрашивайте логические возможности вместо привязки к физическому провайдеру.
В потоке отделяйте частичные данные от итогового результата; обрабатывайте завершение, отмену, ошибки и использование. Обрыв потока не означает успех; нельзя без проверки повторять запись.
Используйте контракт API и версию SDK, одобренные для вашего контура. Передавайте организацию, пространство, пользователя, роль, язык и request ID. Задайте ограниченные таймауты и отмену; для записи используйте идемпотентность. Учитывайте Retry-After и безопасные повторы со случайной задержкой; обновляйте истёкший сеанс с одним повтором.
Учётные данные и области
Самостоятельно подключается только локальный тестовый источник. Для внешнего источника Business администратор должен настроить фиксированный адрес, серверный секрет и права чтения и согласовать пилот; запись в каталоге не означает действующее подключение.
Учётные данные должны оставаться в защищённом контуре, вне запросов и отображаемого браузером результата. Ошибка синхронизации не является основанием расширять доступ.
Интерфейсы разработки
yCode работает с явно выбранными репозиториями в изолированных запусках. Доступные web-, desktop-, редакторские и консольные интерфейсы используют ограниченный доступ и проверку результата.
Запрос сам по себе не разрешает push, merge, удаление или чтение посторонних путей. При ошибке входа в desktop-клиенте проверьте завершение входа в браузере и сеанс клиента.