鉴权接口

POST

/API/OAuth/token

x-request-date的时间不能和当前时间相差超过5分钟，需要传计算signature时用到的x-request-date值，否则验证通不过

请求参数

Header 参数

x-request-date

string

必需

发起请求的时间，格式遵循rfc1123标准，如Wed, 21 Nov 2018 01:29:20 GMT, 有效时间范围是5分钟内

示例值:

Fri, 26 Apr 2024 01:46:32 GMT

Content-Type

string

json 类型

必需

示例值:

application/json

Body 参数application/json

access_key

string

必需

access_key 访问key

signature

string

必需

签名,算法:hash_hmac('sha512', request_timestamp + ak + sk, sk)

示例

{
  "access_key": "896xxxxxxxx",
  "signature": "c4de5xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://ctgcdn.esurfingcloud.com/API/OAuth/token' \
--header 'x-request-date: Fri, 26 Apr 2024 01:46:32 GMT' \
--header 'Content-Type: application/json' \
--data-raw '{
    "access_key": "896xxxxxxxx",
    "signature": "c4de5xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

返回状态码,1为成功，其他为失败

message

string

返回信息

必需

data

object

必需

token

string

必需

access_token，有效期一般为24小时

refresh_token

string

必需

refresh_token(刷新令牌token)，可以用来获取新的access_token

expire

integer

必需

access_token过期时间，unix时间戳

uid

string

必需

access_token所属用户ID

username

string

必需

access_token所属用户名

示例

{
  "code": 1,
  "message": "OK",
  "data": {
    "token": "AxxxxxxxxxxxxxxxxxxxxxXvWWd/",
    "refresh_token": "Hc1RyxxxxxxxxxxxxxxxxxxxxxxxxxxxxxkNPkZ2LypTAM9Loa8qrmrSVYBYe0YZp9ACwVGx6aoB3eAxZ/AvkLkA8IBSf5Ztnk8NDYZ2J-pKg59Lfb8Uz9Ab2VL",
    "expire": 1714182902,
    "uid": "7740",
    "username": "test"
  }
}

修改于 2024-08-07 02:32:18

获取token代码示例