Yasnora AIEN
Разработчикам
Разработчикам · 2026.10

API, SDK и yCode

REST, SDK, webhooks, MCP и инструменты разработки.

Чтение: 2 мин
Проверено 2026-10-25
Двуязычная статья
01

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

Разрешённые интеграции используют версионированные API и SDK Yasnora. Передавайте идентификацию и контекст политики; запрашивайте логические возможности вместо привязки к физическому провайдеру.

В потоке отделяйте частичные данные от итогового результата; обрабатывайте завершение, отмену, ошибки и использование. Обрыв потока не означает успех; нельзя без проверки повторять запись.

Используйте контракт API и версию SDK, одобренные для вашего контура. Передавайте организацию, пространство, пользователя, роль, язык и request ID. Задайте ограниченные таймауты и отмену; для записи используйте идемпотентность. Учитывайте Retry-After и безопасные повторы со случайной задержкой; обновляйте истёкший сеанс с одним повтором.

02

Учётные данные и области

Самостоятельно подключается только локальный тестовый источник. Для внешнего источника Business администратор должен настроить фиксированный адрес, серверный секрет и права чтения и согласовать пилот; запись в каталоге не означает действующее подключение.

Учётные данные должны оставаться в защищённом контуре, вне запросов и отображаемого браузером результата. Ошибка синхронизации не является основанием расширять доступ.

03

Интерфейсы разработки

yCode работает с явно выбранными репозиториями в изолированных запусках. Доступные web-, desktop-, редакторские и консольные интерфейсы используют ограниченный доступ и проверку результата.

Запрос сам по себе не разрешает push, merge, удаление или чтение посторонних путей. При ошибке входа в desktop-клиенте проверьте завершение входа в браузере и сеанс клиента.

Ответственный: platform · Редакция 2026-10-25 · Документация 2026.10