Закодированные тела запросов в Blueprint на apiary.io

У нас есть один существующий API, для которого мы пытаемся создать Blueprint, который требует, чтобы определенные тела запросов были JSON в кодировке URI.

Есть ли способ указать тело как «подобное этому, но закодированное»?

Существующая (просто текстовая) документация просто показывает JSON вместе с простым напоминанием о необходимости кодирования перед отправкой:

POST /blah/blah/blah
Content-Type: application/x-www-form-urlencoded
Parameters: (x-www-form-urlencoded)

        { "title": "Buy cheese and bread for breakfast." }

Но с Blueprint — и особенно с Blueprint на apiary.io — вам действительно нужно показать настоящее тело. Что совершенно нечитаемо:

### Create a Note [POST]
+ Request (application/x-www-form-urlencoded)

        %7B%20%22title%22%3A%20%22Buy%20cheese%20and%20bread%20for%20breakfast.%22%20%7D

Но указать читаемый текст в Blueprint не удается (возвращает ошибку параметра):

### Create a Note [POST]
+ Request (application/x-www-form-urlencoded)

        { "title": "Buy cheese and bread for breakfast." }

Настоящим камнем преткновения является то, что когда Apiary обращается к моему реальному серверу: читаемый запрос завершается неудачно (потому что он не закодирован), а нечитаемый выполняется успешно (потому что, как и требовалось, так оно и есть).


person jackr    schedule 12.11.2013    source источник
comment
Итак, если я прав, вопрос в том, можно ли указать незакодированный JSON для тела сообщения application/x-www-form-urlencoded Conten-Type, чтобы API Blueprint (анализатор) кодировал его во время синтаксического анализа?   -  person Zdenek    schedule 13.11.2013
comment
Да, это идея.   -  person jackr    schedule 09.01.2014


Ответы (1)


Я считаю, что это еще не поддерживается, но отслеживается здесь: https://github.com/apiaryio/api-blueprint/issues/25

person PETER BROWN    schedule 24.12.2013