如何在apiary.io上格式化POST请求？

Question

感谢您的时间我有一个POST请求,我想在蓝图养蜂场中记录,标题是这样的:

text/html的

_method:POST

数据[用户] [用户名]:

数据[用户] [口令]:

数据[用户] [记住]:0

http://d.pr/i/uRFx

我有类似的东西,但我不知道如何完成它:

## login [/users/login/{username}{password}{remember}{ident}]
Login with a user and password

+ Parameters

    + username (required, string, `myname`) ... the username format should follow CakePHP: data[User][username].
    + password (required, string, `whatever`) ... the password format should follow CakePHP: data[User][password]
    + remember (required, number, `0`) ... the remember format should follow CakePHP: data[User][remember]
    + ident (optional, number, `0`) ... the ident format should follow CakePHP: data[User][ident]

### make login [POST]

+ login by user (text/plain)
What goes in here???????????

任何的想法？谢谢!

Answer 1

显然,这是以网络形式提交数据.在这种情况下,Content-Type属于该application/x-www-form-urlencoded类型.

请求的消息体具有特殊格式,并且其中一些章程(方括号)必须为%-escaped.有关请求正文格式的详细信息,请参阅上述Wiki文章.

最简单形式的API蓝图可能是这样的:

# Login [/users/login]
## Make Login [POST]
+ Request (application/x-www-form-urlencoded)

        data%5BUser%5D%5Busername%5D=qq&data%5BUser%5D%5Bpassword%5Dqq&data%5BUser%5D%5Bremember%5D=0

+ Response 201

您应该可以在"查看URL编码"链接下的流量检查器中查看请求消息正文的示例.

请参阅此蓝图以查看此示例的实际操作.

有关详细信息,请参阅此SO问题application/x-www-form-urlencoded.