直达内容

多个用户

POST /users/fetch​

获取多个用户的基本信息。

信息

该 API 只会返回存在用户的信息，如果用户不存在并不会报错。

API 端点 URL

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

授权和其他选项

授权
PROFILE:READ; 如果用户有 `PHONE:READ` 授权，会返回用户的手机号。
限制No limitation

请求体

[
  // array of 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
    },
    ...
  ]
}