OAuth认证

请求

接口地址 /oauth/token

参数说明

参数 是否必须参数 描述
grant_type 必须参数 固定为“client_credentials”
client_id 必须参数 应用的 App Id
client_secret 必须参数 应用的 App Secret

示例

copy
POST /oauth/token HTTP/1.1
Host: vms.fetiononline.com
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&client_id=xxxxxxxxxx
&client_secret=xxxxxxxxxx

响应

参数说明

参数 是否必须参数 描述
access_token 必须参数 访问令牌
scope 必须参数 授权范围
expires_in 必须参数 过期时间,单位为秒

示例

copy
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache

{
	"access_token":"xxxxxxxxxx",
	"scope":"public",
	"expires_in":86400,
}

错误示例

  • invalid_request – 错误的请求,缺少参数
  • invalidclient – 客户端身份验证失败,如请求包含无效clientid或client_secret。在这种情况下发送HTTP 401响应。
  • invalid_grant – 授权类型无效。
copy
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache

{
  "error": "invalid_request",
  "error_description": "Request was missing the 'client_id' parameter.",
  "error_uri": "See the full API docs at https://vms.fetiononline.com/docs/oauth.html"
}

访问资源示例

需要在header中加入

Authorization: Bearer access_token

copy
POST /resources HTTP/1.1
Host: vms.fetiononline.com
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer access_token
认证方式