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

Question

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

文本/html

_方法: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

显然这是submitting the data in a web form .在这种情况下，Content-Type属于 application/x-www-form-urlencoded类型。

请求的消息正文具有特殊格式，并且其某些章程(方括号)必须进行 %-escaped。有关请求正文格式的详细信息，请参阅 aforementioned Wiki article .

最简单形式的 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 编码”链接下的流量检查器中看到请求消息正文的示例。

引用 this blueprint看看这个例子。

另请参阅 this SO question有关 application/x-www-form-urlencoded 的更多详细信息.