查询指定 YCM 用户

查询指定 YCM 用户的信息。

请求 URL

GET {base_url}/dm/open_api/v1/users/{userId}

请求参数

路径参数
表 1.
参数 是否必填 类型 说明
userId 是 Long YCM 用户 ID。
注： 可使用 查询所有 YCM 用户 接口查询用户 ID。
请求头
参数 是否必填 类型 说明
Authorization 是 String 在请求头中传递访问 Token。

格式：Bearer {access_token}。

响应参数

参数 类型 说明
data Object <Details> 详情。
requestId String 请求 ID，作为该请求的唯一标识，用于快速定位请求。
status String 请求结果。
  • Success：请求成功。
  • Failed：请求失败。
time Long 请求响应的时间。
注： YCM API 响应返回的是时间戳，如有需要，你可以将时间戳转换成具体的日期和时间。详细操作方法，请参见 将时间戳转换为日期和时间。
Details
参数 类型 说明
userId Long 用户 ID。
company String 公司名称。
firstName String 名称。
lastName String 姓氏。
email String 邮箱。
phone String 电话号码。
mobile String 手机号码。
address String 地址。
remark String 备注。
createdCloudPbx Integer 创建的 PBX 数量。
注： 当用户类型为 Hosting User 时，此字段返回该托管用户及其同事、该托管用户的下级经销商及其同事所创建的 PBX 的总数量。
createdReseller Integer 托管用户创建的经销商数量。
注： 此字段仅在用户类型为 Hosting User 时返回。
userType String 用户类型。
  • My Colleague：我的同事
  • Hosting User：托管用户

示例

请求示例

查询 YCM 用户 (ID：13123) 的信息。

GET /dm/open_api/v1/users/13123 HTTP/1.1
Host: ycm.yeastar.com
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjdXN0b21Kd3RQYXlsb2FkSW5mbyI6eyJncmFudFR5cGUiOiJjbGllbnRfY3JlZGVudGlhbHMiLCJ5c0lkIjoxNzg5NjM2MDM5MDg1MDI1NzM0OSwidmVyc2lvbiI6MTYzODk1OTkwOSwicmVmcmVzaFZlcnNpb24iOjE2Mzg5NjI4NDB9LCJzY29wZSI6WyJhbGwiXSwiZXhwIjoxNjM4OTY0NjQwLCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiJmZjBiNWM1MS03YjBhLTQwYjYtYTRkNS04ZWZkMzY1OGJlZDkiLCJjbGllbnRfaWQiOiJrcDl5eW50bXVlc3VrNWpvV3ZNa1RiQ0J4cU82TEtSaCJ9.RNiea7bNZtBO5QWvnChhK8m-Bcg_qSZY5gods0Gq7z0

响应示例

HTTP/1.1 200 OK
{
  "data": {
        "userId": 13123,
        "company": "Yeastar",
        "firstName": "Leo",
        "lastName": "Ball",
        "email": "leo@example.com",
        "phone": "13988888888",
        "address": "USA",
        "createdCloudPbx": 10,
        "createdReseller": 3,
        "userType": "Hosting User"
      },
  "requestId": "a3a2876051d863c3d30431ba8bee42c8",
  "status": "Success",
  "time": 1664343275
}