获取用户账号对应的数据中心信息
更新时间:2025-05-30 14:20:53
获取用户账号对应的数据中心信息。 国内通过中国大陆数据中心网关域名调用查询,海外可通过海外任 一数据中心网关域名调用查询。
描述 | 值 |
---|---|
路径 | /platform/user/region/get |
版本号 | 1.0.0 |
协议 | HTTPS |
请求方法 | POST |
请求参数:
公共请求参数见 公共请求参数
不需要cloudToken参数
请求字段 | 类型 | 必选 | 描述 |
---|---|---|---|
type | String | 是 | 查询模式,可取值为 COUNTRY_CODE(国家code查询模式),PHONE(手机号码模式),EMAIL(邮箱模式),THIRD_AUTHCODE(三方账号授权code模式)。 |
countryCode | String | 否 | 国家二位标识码,例如 CN,type为COUNTRY_CODE 时有效 |
phone | String | 否 | 手机号码,type为PHONE时有效。 |
String | 否 | 邮箱,type为EMAIL时有效。 | |
authCode | String | 否 | AuthCode,type 为 THIRD_AUTHCODE 时有效。 |
返回参数:
返回字段 | 类型 | 描述 |
---|---|---|
id | String | 用于识别请求记录,即对应的请求ID。 |
code | Int | 接口返回码字段,请求成功时返回200;请求失败时返回详细的错误码。 |
message | String | 调用失败时,返回的出错信息。 |
data | Object | 响应的结果。 |
regionId | Int | 账号所属数据中心id |
apiGatewayEndpoint | String | 账号所属数据中心网关域名 |
regionEnglishName | String | 账号所属数据中心英文名称。 |
请求示例:
x-ca-key: xxxxxxxx
x-ca-timestamp: 1728634151000
x-ca-nonce: 7b25fc15b9434dd98587a077a92b7e42
x-ca-signature: yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy
Content-Type: application/json;charset=UTF-8
{
"id": "49a7be925e******8ba0facf7",
"version": "1.0",
"request": {
"apiVer": "1.0.0"
},
"params": {
"type": "COUNTRY_CODE",
"countryCode": "US"
}
}
成功返回示例:
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache
{
"id": "49a7be925e******8ba0facf7",
"code": 200,
"message": "success",
"data": {
"regionId": 3,
"apiGatewayEndpoint":"third-gateway.iotrtcus.com",
"regionEnglishName": "US_WEST"
}
}