Справочник — пример 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.
- Читаются ли вложенные схемы и длинные имена полей.
- Находит ли поиск текст руководства и описание операции.
- Сохраняется ли удобство на узком экране.