如何格式化apiary.io上的POST请求?
感谢您的时间我有一个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???????????
任何想法? 谢谢!
显然这是以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编码”链接下的流量检查器中查看您的请求消息体的示例。
请参阅此蓝图以查看此示例。
有关application/x-www-form-urlencoded
更多详细信息,请参阅此SO问题。