Справочник — пример Dictionary
Здесь показаны два самостоятельных API сервиса Dictionary. Они используются только как реальные входные данные для сравнения генераторов и не являются контрактами Affiliate API.
| Контракт | Версия OpenAPI | Содержимое |
|---|---|---|
| Dictionary Static API | 3.0.3 | Пакетное получение статических данных по идентификаторам объектов: 1 операция |
| Dictionary gRPC Gateway | 3.0.3 | HTTP-представление методов Dictionary: 13 операций |
Выберите API и метод в боковой навигации. Сравните параметры, request body, ответы и модели данных. Скачиваемые исходники одинаковы во всех четырёх вариантах демо.
Как читать примеры
Во все четыре сборки передан один общий набор синтетических примеров, выведенных из схем. Они иллюстрируют форму сообщения и не подтверждают наличие объекта или оффера в рабочей системе. Отправка запросов отключена.
Оригинальные YAML сохранены без изменений. Для отображения используется общая демо-копия: добавлены только примеры, название Gateway и синтетический адрес https://dictionary.example.invalid. Методы, поля, ответы и версии исходных контрактов не изменены.
В Static API начните с resolveStaticProperties. В Gateway откройте HotelDetailService_GetHotelProperty, затем сравните связанные модели и параметры запроса.
Что проверить при сравнении
- Удобно ли переходить между руководствами и API.
- Читаются ли вложенные схемы и длинные имена полей.
- Находит ли поиск текст руководства и описание операции.
- Сохраняется ли удобство на узком экране.