跳到主要内容
版本：4.1

单用户查询

接口说明​

查询空间中单个用户的全部特征，包括全部身份值、用户属性和用户标签

接口地址​

http://{api-host}/v1/api/projects/{projectId}/spaces/{spaceId}/users/{identityKey}/{identityValue}

请求方式​

GET

公共请求参数​

公共请求参数

请求参数​

名称类型必填描述示例值
projectIdString是搜索用户所在项目 IDWlGk4Daj
spaceIdString是搜索用户所在空间 IDVKwkPmqX
identityKeyString是搜索的用户身份标识符$basic_userId
identityValueString是搜索的用户身份值U3803180317

返回数据​

名称类型描述
gioIdIntGrowingIO 系统生成的用户标示
identifications< String , List >系统用户的全部用户身份值
propertiesObjective系统用户的全部用户属性和用户标签

示例 1：根据项目 ID、空间 ID 和用户 ID 搜索用户​

场景：在项目 WlGk4Daj 空间 VKwkPmqX 中搜索 用户 ID 为 U3803180317 用户的全部用户身份、用户属性和用户标签

请求示例​

curl --location --request GET 'http://{api-host}/v1/api/projects/WlGk4Daj/spaces/VKwkPmqX/users/$basic_userId/U3803180317'
--header 'Authorization: Bearer c2ff9aa1-1824-4cc7-a01f-4094293a6af9'

返回示例​

{
    "gioId": "13831",
    "identifications": {
        "ids_$basic_userId": ["U3803180317"],
        "ids_$anonymous_user": ["X","Y"]
    },
    "properties": {
        "usr_$basic_name": "陈一一",
        "usr_age": "28",
        "usr_address": null,
        ...
        "tag_30day_payment_sum": "3519.3",
        "tag_RFM_level": "高",
        "tag_last_buy": null,
        ...
    }
}

示例 2：根据项目 ID、空间 ID 和设备 ID 搜索用户​

场景：在项目 WlGk4Daj 空间 VKwkPmqX 中搜索 设备 ID 为 X 用户的全部用户身份、用户属性和用户标签

请求示例​

curl --location --request GET 'http://{api-host}/v1/api/projects/WlGk4Daj/spaces/VKwkPmqX/users/$anonymous_user/X'
--header 'Authorization: Bearer c2ff9aa1-1824-4cc7-a01f-4094293a6af9'

返回示例​

{
    "gioId": "13831",
    "identifications": {
        "ids_$basic_userId": ["U3803180317"],
        "ids_$anonymous_user": ["X","Y"]
    },
    "properties": {
        "usr_$basic_name": "陈一一",
        "usr_age": "28",
        "usr_address": null,
        ...
        "tag_30day_payment_sum": "3519.3",
        "tag_RFM_level": "高",
        "tag_last_buy": null,
        ...
    }
}

示例 3：搜索用户不存在或未授权给项目、空间​

场景：搜索用户不存在或未授权给项目、空间

请求示例​

curl --location --request GET 'http://{api-host}/v1/api/projects/WlGk4Daj/spaces/VKwkPmqX/users/$anonymous_user/Z'
--header 'Authorization: Bearer c2ff9aa1-1824-4cc7-a01f-4094293a6af9'

返回示例​

{
  "gioId": "0",
  "identifications": {},
  "properties": {}
}