URL: /api/v1/captcha
操作分为获取验证码和验证验证码
当前设计:
获取验证码使用 POST URL,表示创建一个新的验证码,Content body 为
{
"id": "request id"
}
Body 如果为空的时候,去 Header 里边取 X-Request-ID
,如果都为空,则随机生成一条 UUID 作为对应的验证码 ID
返回内容为:
{
"id": "captcha id",
"data": "captcha image base64"
}
验证验证码的时候使用 DELETE URL,因为每个验证码只验证一次,相当于删除操作。
Content Body 内容为:
{
"id": "captcha id",
"value": "captcha value"
}
验证失败时返回 400 外加失败内容:
{
"code": 400,
"message": "captcha verify failed"
}
验证成功时返回 204 空 Body
我第一次写 RESTful API 后端,请问各位这种设计是否符合规范?
是否有更好设计?
这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。
V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。
V2EX is a community of developers, designers and creative people.