直达内容

批量查询用户

POST /users/fetch​

根据用户 ID 批量获取用户信息。

信息

仅返回已存在的用户，未找到的用户会被忽略。

API 端点 URL

 https://api.mixin.one/users/fetch

授权和其他选项

授权
PROFILE:READ; 如授予 `PHONE:READ` 权限，可获取用户手机号
限制No limitation

请求体

[
// user_id 数组
"UUID",
"UUID",
"UUID"
]

请求示例

curl -i -X POST -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" https://api.mixin.one/users/fetch --data '["06aed1e3-bd77-4a59-991a-5bb5ae6fbb09"]'
Response
{
  "data": [
    {
      "type":             "user",
      "user_id":          "773e5e77-4107-45c2-b648-8fc722ed77f5",
      "identity_number":  "7000",
      "phone":            "+8613801380138",
      "full_name":        "Team Mixin",
      "biography":        "",
      "avatar_url":       "https://images.mixin.one/E2y0BnTopFK9qey0YI-8xV3M82kudNnTaGw0U5SU065864SsewNUo6fe9kDF1HIzVYhXqzws4lBZnLj1lPsjk-0=s256",
      "relationship":     "STRANGER",
      "mute_until":       "0001-01-01T00:00:00Z",
      "created_at":       "2017-12-23T18:23:26.996149Z",
      "is_verified":      true
    },
    ...
  ]
}