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

Question

感谢您的时间我有一个 POST 请求，我想在蓝图养蜂场中记录，标头如下所示：

文本/网页

_method：开机自检

数据[用户][用户名]：

数据[用户][密码]：

数据[用户][记住]：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

显然，

这是在Web表单中提交数据。在这种情况下，Content-Type是application/x-www-form-urlencoded类型。

请求的消息正文具有特殊的格式，并且其某些章程（方括号）也必须进行%转义。有关请求正文格式的详细信息，请参阅前面提到的 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的更多详细信息。