Как я могу получить несколько%-кодированных параметров в шаблон URI пасеки?

Question

Спецификация ApiaryIO - фактически RFC, на которую он указывает - указывает, что вы не можете использовать "." в имени параметра вам нужно закодировать его в "%2E". Это нормально, но, похоже, есть ошибка, когда Apiary может обрабатывать только одну такую ​​кодировку. Например, следующее

## Notes Collection [/notes{?foo%2Ebar}]

дает следующий пример кода

request = Request('http://private-d1ee7-testingnewapiary.apiary-mock.com/notes?foo.bar=foo.bar')

что правильно. Тем не менее, следующее

## Notes Collection [/notes{?foo%2Ebar,baz%2Ebla}]

дает этот пример кода:

request = Request('http://private-d1ee7-testingnewapiary.apiary-mock.com/notes?foo%252Ebar=foo%252Ebar&baz%252Ebla=baz%252Ebla')

Обратите внимание, что в первом примере кода вы видите "foo.bar", но во втором примере "foo%252Ebar", что неверно.

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

Как мне закодировать много "." Содержащих параметров в шаблоне URI и все же получить правильные примеры кода?

Answer 1

Поможет ли добавление явных примеров значений для этих параметров?

Например:

## Notes Collection [/notes{?foo%2Ebar,baz%2Ebla}]
+ Parameters
    + foo%2Ebar (`42`)
    + baz%2Ebla (`24`)

---

Обновить

Это похоже на ошибку в способе отображения документации / примеров кода. Я создал проблему с отслеживанием здесь https://github.com/apiaryio/language-templates/issues/36.