Каково назначение параметра Host: в Apiary?

Для чего нужен параметр Host: в Apiary. Например:

FORMAT: 1A
HOST: http://polls.apiblueprint.org/

person βξhrαng    schedule 25.05.2015    source источник


Ответы (1)


В заголовке HOST указывается окончательное предполагаемое развертывание вашего API.

Он используется на Apiary как исходное расположение для отладки прокси-сервера и отображается во фрагментах кода как место для запросов.

Вы также можете добавить суффиксы, которые затем распространяются на все ресурсы, если вы не работаете с правами root или хотите использовать версию через URI.

Макет и прокси-сервер также эмулируют указанную вами схему (http против https).

Ресурсы:

person Almad    schedule 25.05.2015
comment
Спасибо. Мне пришлось копнуть немного глубже, чтобы найти нужную мне информацию. Ссылка на спецификацию не объясняет назначение параметра Host, а только то, что это метаданные. Однако благодаря разделу Traffic Inspector здесь, а также этот пост блога и раздел настроек Приложение, теперь все ясно. - person βξhrαng; 25.05.2015
comment
Нет проблем — Apiary сейчас проводит большую подготовительную работу, чтобы сделать документацию и ее опыт намного лучше :) Обновлен ответ со ссылками. - person Almad; 25.05.2015
comment
Полчаса возился с вашим продуктом. Чрезвычайно плохая документация и ничего простого. Существуют и другие сервисы, где вы можете создавать макеты менее чем за 5 минут, даже не читая никакой документации или, что еще хуже, прибегая к Stackoverflow, чтобы получить и запустить даже самый простой макет. Категорически не могу рекомендовать этот сервис. - person AndroidDev; 05.09.2015
comment
@AndroidDev Цель Apiary выходит далеко за рамки создания фиктивных сервисов, поэтому его настройка немного сложнее. Мы работаем над улучшением документации (см. новый портал для разработчиков), и она также появится в FTUE. - person Almad; 05.09.2015