Сравнение возможностей
native.api задаёт API через карты роутов и контроллеры. Штатный rest предоставляет методы, зарегистрированные модулями платформы. Сравнение относится к серверному модулю rest 26.650.0; состав методов и доступность авторизации зависят от установленного продукта и модулей.
| Механизм | native.api | rest |
|---|---|---|
| Описание операций | Карта с URL, HTTP-методами, параметрами и правилами доступа | Реестр именованных REST-методов модулей |
| Расширение | Контроллеры и события этапов запроса | Регистрация собственных методов, в том числе через OnRestServiceBuildDescription |
| Авторизация | Basic и локальные пары access/refresh-токенов для клиентов пользователя | OAuth-приложения и входящие вебхуки |
| Форматы ответа | JSON и XML; служебная обёртка успешного ответа отключается для роута | JSON и XML в формате ответа REST |
Для API с собственной структурой URL, правилами валидации и ответами используйте возможности native.api. Если интеграция уже обращается к методам rest, её контракт и авторизацию нужно учитывать отдельно: совпадение формата JSON/XML не делает API взаимозаменяемыми.