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

  显示原文与译文双语对照的内容
0 0

我想使用RAML来描述一个使用OAuth2 API

你们谁有解决方案或示例我可以用于比较与自己RAML我的api?

时间:原作者:2个回答

0 0

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

securitySchemes : oauth_2_0: 描述: | dropbox支持OAuth 2 .0用于验证所有API请求。 输入以下命令: OAuth 2 .0 describedBy : 头: 授权: 描述: | 用于发送有效OAuth 2 访问令牌。 不要使用 与" access_token " 查询字符串参数。 输入以下命令: 字符串 queryParameters : access_token: 描述: | 用于发送有效OAuth 2 访问令牌。 不要使用一起 " 授权" 标头 输入以下命令: 字符串 回复: 401: 描述: | 错误或过期的令牌。 产生该用户或Dropbox 吊销或过期的访问令牌。 要修复,应re 验证用户的身份。 403: 描述: | 一个糟糕的OAuth请求( 错误的使用方密钥,nonce,过期 时间戳。。。) 。 不幸的是,re使用户不会帮忙耶 设置: authorizationUri : https://www .dropbox .com/1/oauth2/authorize accessTokenUri : https://api .dropbox .com/1/oauth2/token authorizationGrants : [ 代码,令牌] 
原作者:
0 0

下面是一个实际示例,建模中的GitHub v3 API RAML 。

门户的spec : http://www .apihub .com/github/api/github api v3/docs/raml

RAML文件可通过该链接顶部的门户。

点击" Explore与API Notebook " 按钮来玩( script ) 浪潮API,使用其OAuth2规范与内建OAuth2客户端。?

原作者:
...