Есть ли способ отправить пустые необязательные параметры запроса?

Question

Я пишу документацию по API и получил проблемы.

Вот определение ссылка:

### Get hotels availability [GET /agent/v1/hotel/availability{?regions,hotels,from,to,limit,offset}] 

Параметры:

+ Parameters 
    + regions (required,string,`399,189`) 
    + hotels (optional, string, `1844`) 
    + from (optional, string, `2016-03-12`) 
    + to (optional, string, `2016-03-19`) 
    + limit (optional, number, `1`) 
    + offset (optional, number, `0`) 

Когда я пытаюсь отправить запрос с пустым hotels параметра, например, пасека использует 1844 вместо пустой. Если я попытаюсь проигнорировать его, то будет отправлен hotels=hotels.

Есть ли способ отправить пустой для необязательного параметра или вообще не отправить его?

Вот ссылка с скриншоте: http://www.awesomescreenshot.com/image/1008356/09614be501945b0644fd84a06e311404

Answer 1

Я не уверен, понимаю ли я вашу проблему правильно. Я попытался воспроизвести описанное вами поведение. Я создал новый API проект в Пасеке и написал следующий API Blueprint:

FORMAT: 1A 

# Hotels API 

# Group Hotels 

## Hotels [/agent/v1/hotel/availability{?regions,hotels,from,to,limit,offset}] 

+ Parameters 
    + regions (required,string,`399,189`) 
    + hotels (optional, string, `1844`) 
    + from (optional, string, `2016-03-12`) 
    + to (optional, string, `2016-03-19`) 
    + limit (optional, number, `1`) 
    + offset (optional, number, `0`) 

### Get hotels availability [GET] 

+ Response 200 (application/json) 

     {"hello":"world"} 

Затем я открыл консоль панели в генерируемой интерактивной документации и попытался изменить параметры URL:

URL-адрес в верхняя часть меняется правильно. Я сделал некоторые запросы с консолью и на странице Traffic Inspector, кажется, подтверждают, что правильные параметры были отправлено:

Я думаю, вы должны уточнить свой вопрос и предоставить более подробную информацию. Кроме того, я считаю, что это довольно специфическая тема для Apiary, и может быть больше смысла связываться с поддержкой Apiary в support@apiary.io. Если электронная почта не ваша вещь, есть также интерактивный чат:

---

Отказ от ответственности: На момент написания ответа я работаю Пасека.