文档首页/微服务引擎 CSE/API参考/ServiceComb API/认证/获取ServiceComb引擎专享版用户Token - ObtainUserTokenOfExclusiveMicroserviceEngine
更新时间：2026-03-06 GMT+08:00
查看PDF
分享

获取ServiceComb引擎专享版用户Token - ObtainUserTokenOfExclusiveMicroserviceEngine

功能介绍

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

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

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

Authorization:Bearer {Token}

接口约束

无

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

POST /v4/token

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

ServiceComb引擎账号名称。

password

是

String

ServiceComb引擎账号密码。

响应参数

状态码： 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.****************.****************-2JxeUe3eOl5Md5kzOIAE_EYUATxCbJ5GmgpSSJf*****"  
}

状态码

状态码

描述

200

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

401

错误的请求，鉴权失败。

500

服务内部错误

错误码

请参见ServiceComb错误码。

父主题：认证

相关文档