文档首页/ 微服务引擎 CSE/ API参考/ ServiceComb API/ 认证/ 获取ServiceComb引擎专享版用户Token
更新时间:2024-01-29 GMT+08:00

获取ServiceComb引擎专享版用户Token

功能介绍

仅用于开启了安全认证的ServiceComb引擎专享版。

在访问开启了安全认证的ServiceComb引擎专享版的接口前,需要先调用该接口获取用户Token,该Token是访问接口的唯一凭据。

发送访问请求时需要在请求头中带上该Token,格式为:

Authorization:Bearer {Token}

接口约束

URI

POST /v4/token

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

name

String

用户账号名称。

password

String

用户账号密码。

响应参数

状态码: 200

表2 响应Body参数

参数

参数类型

描述

token

String

获取的用户Token,有效期为12小时。

状态码: 401

表3 响应Body参数

参数

参数类型

描述

errorCode

String

错误代码。

errorMessage

String

错误信息。

detail

String

详细定位信息。

状态码: 500

表4 响应Body参数

参数

参数类型

描述

errorCode

String

错误代码。

errorMessage

String

错误信息。

detail

String

详细定位信息。

请求示例

POST https://{服务注册发现地址}/v4/token

{
    "name": "root",
    "password": "*******"
}

响应示例

状态码: 200

用于获取用户Token的响应结构体。

{
  "token" : "****bGciOiJSUzUxMiIsInR5cCI6IkpXVCJ9.eyJhY2NvdW50Ijoicm9vdCIsImV4cCI6MTY1MDU5MTcwMSwicm9sZXMiOlsiYWRtaW4iXX0.WKwNAjaYMMCSjNX0qCGCeyh13FJRzLousxoXlThdkMwkH- pXEmG51_SguH0LlHOZoIc8gNJq-ilQg4bxTo1s0pnQZIS3wma0qvE-MzaYnFguTuHM7rxD7eZdwnbUe3dhnw9xRqR1hcd-lTuBbLoL9fbED4U_63IoEDyBCJl9D_l0F86uGzpUysCvC-t6MrJHgi7miUaO7ZZQmSAUNhmbEoN8IIVp-QtP_cWNWtWaFO-eoQrmCT2FdlYiB9MCuELr9-5EGM_mFLPgs6E4fyIGiGHy7IwoGUKOCW5w6Jb0l-2JxeUe3eOl5Md5kzOIAE_EYUATxCbJ5GmgpSSJf*****"
}

状态码

状态码

描述

200

用于获取用户Token的响应结构体。

401

错误的请求,鉴权失败。

500

服务内部错误

错误码

请参见错误码