api - 如何使用 RAML 来描述使用 OAuth2 的 API

Question

关闭。这个问题不满足Stack Overflow guidelines .它目前不接受答案。












想改善这个问题吗？更新问题，使其成为 on-topic对于堆栈溢出。

7年前关闭。




Improve this question




我想使用 RAML 来描述使用 OAuth2 的 API

有没有人有我可以用来与我自己的 api 的 RAML 进行比较的解决方案或示例？

Answer 1

来自 https://github.com/raml-org/raml-spec/blob/master/08_security.md#declaration :

安全方案:
- oauth_2_0:
说明: |
Dropbox 支持 OAuth 2.0 来验证所有 API 请求。
类型:OAuth 2.0
描述者:
标题:
授权:
说明: |
用于发送有效的 OAuth 2 访问 token 。不使用
使用“access_token”查询字符串参数。
类型:字符串
查询参数:
访问 token :
说明: |
用于发送有效的 OAuth 2 访问 token 。请勿与
“授权”标题
类型:字符串
回应:
401:
说明: |
错误或过期的 token 。如果用户或 Dropbox
撤销或过期访问 token 。要修复，您应该重新
验证用户。
403:
说明: |
错误的 OAuth 请求(错误的消费者 key 、错误的随机数、过期
时间戳...)。不幸的是，重新验证用户在这里无济于事。
设置:
授权Uri:https://www.dropbox.com/1/oauth2/authorize
accessTokenUri:https://api.dropbox.com/1/oauth2/token
授权:[代码， token ]