# 00-赋权

# 1 赋权

# 1.1 获取 Token(POST)

API 的安全机制,获取 Token 令牌,Access_Token 过期时间为 15天,Refresh_Token 过期时间为 180天。若 Access_Token 过期, 可用 Refresh_Token 重新刷新,Refresh_Token 过期,需要重新登陆。

# URL

https://developers.cjdropshipping.com/api2.0/v1/authentication/getAccessToken

# CURL

curl --location --request POST 'https://developers.cjdropshipping.com/api2.0/v1/authentication/getAccessToken' \
                --header 'Content-Type: application/json' \
                --data-raw '{
                    "email": "v0pjsw5t@linshiyouxiang.net",
                    "password": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
                }'
参数名称 参数意义 参数类型 是否必传 长度 备注
email 邮箱 string 200 CJ 账户的 Email (opens new window)
password 密码 string 200 获取 API Key (opens new window)

# 返回

success

{
    "code": 200,
    "result": true,
    "message": "Success",
    "data": {
        "accessToken": "c50f01a5d910400fb401944569fe0b0c",
        "accessTokenExpiryDate": "2021-07-12T20:08:13+08:00",
        "refreshToken": "16bb512baf74491ba25ea65b8b2dd597",
        "refreshTokenExpiryDate": "2021-08-04T20:08:13+08:00",
        "createDate": "2021-07-05T20:08:13+08:00"
    },
    "requestId": "31c7760c-068e-41c7-aeed-5f2a7f598f22"
}
返回字段 字段意思 字段类型 长度 备注
accessToken Access Token string 200
accessTokenExpiryDate Access Token 过期时间 string 200
refreshToken Refresh Token string 200
refreshTokenExpiryDate Refresh Token 过期时间 string 200
createDate 创建时间 string 200

error

{
    "code": 1601000,
    "result": false,
    "message": "User not find",
    "data": null,
    "requestId": "a18c9793-7c99-42f9-970b-790eecdceba2"
}
返回字段 字段意思 字段类型 长度 备注
code 错误码 int 20 返回错误码标准表
result 是否正常返回 boolean 1
message 返回信息 string 200
data 接口数据返回
requestId 请求Id string 48 用于日志查询错误

# 1.2 刷新 Token(POST)

API 的安全机制,用于 Access_Token 过期后,重新刷新 Access_Token 的过期时间,Access_Token 刷新的过期时间为 15天。

# URL

https://developers.cjdropshipping.com/api2.0/v1/authentication/refreshAccessToken

# CURL

curl --location --request POST 'https://developers.cjdropshipping.com/api2.0/v1/authentication/refreshAccessToken' \
                --header 'Content-Type: application/json' \
                --data-raw '{
                    "refreshToken": "3d3b01404da04be8b6795d7e9823cee5"
                }'
参数名称 参数意义 参数类型 是否必传 长度 备注
refreshToken 刷新 Token string 80

# 返回

success

{
    "code": 200,
    "result": true,
    "message": "Success",
    "data": {
        "accessToken": "c50f01a5d910400fb401944569fe0b0c",
        "accessTokenExpiryDate": "2021-07-06T04:08:13+08:00",
        "refreshToken": "16bb512baf74491ba25ea65b8b2dd597",
        "refreshTokenExpiryDate": "2021-08-04T20:08:13+08:00",
        "createDate": "2021-07-05T20:08:13+08:00"
    },
    "requestId": "31c7760c-068e-41c7-aeed-5f2a7f598f22"
}
返回字段 字段意思 字段类型 长度 备注
accessToken Access Token string 200
accessTokenExpiryDate Access Token 过期时间 string 200
refreshToken Refresh Token string 200
refreshTokenExpiryDate Refresh Token 过期时间 string 200
createDate 创建时间 string 200

error

{
    "code": 1600003,
    "result": false,
    "message": "Refresh token is failure",
    "data": null,
    "requestId": "0b20dc1a-0043-43a7-a7c0-51ca6c61d976"
}
返回字段 字段意思 字段类型 长度 备注
code 错误码 int 20 返回错误码标准表
result 是否正常返回 boolean 1
message 返回信息 string 200
data 接口数据返回
requestId 请求Id string 48 用于日志查询错误

# 1.3 登出(POST)

API 的安全机制,登出后,Access_Token 和 Refresh_Token 都会失效。

# URL

https://developers.cjdropshipping.com/api2.0/v1/authentication/logout

# CURL

curl --location --request POST 'https://developers.cjdropshipping.com/api2.0/v1/authentication/logout' \
                --header 'CJ-Access-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'

# 返回

success

{
    "code": 200,
    "result": true,
    "message": "Success",
    "data": true,
    "requestId": "b1d3728d-8a29-417e-9983-6df9926aaa49"
}
返回字段 字段意思 字段类型 长度 备注
code 错误码 int 20 返回错误码标准表
result 是否正常返回 boolean 1
message 返回信息 string 200
data 接口数据返回
requestId 请求Id string 48 用于日志查询错误

error

{
    "code": 1600001,
    "result": false,
    "message": "Authentication failed",
    "data": null,
    "requestId": "5aa2bb6e-42fa-4e0a-ae88-1833c2c1c883"
}
返回字段 字段意思 字段类型 长度 备注
code 错误码 int 20 返回错误码标准表
result 是否正常返回 boolean 1
message 返回信息 string 200
data 接口数据返回
requestId 请求Id string 48 用于日志查询错误