对象列表

开发中

POST

/leads/open-api/object-list

客户数据平台（CDP）/线索Leads/高级筛选

最后修改时间：2025-03-13 02:01:53

接口描述

可通过该接口，获取对象数据，并支持条件筛选

接口调用限制为

每秒50次。

请求参数说明

通用参数 access_token （使用鉴权模块-获取token接口获取）

参数名称	参数类型	必须	说明
user_id	string	是	系统用户的user_id，以该系统用户的数据权限返回数据。获取方法：1.通过管理员列表接口获取 2.登录系统获取，位置：个人设置-用户ID
schema_name	对象名称	是	竞争对象：Competitors 竞对明细：CompetitiveDetails
condition	array	否	数据查询条件，为空则返回所有数据。支持多字段组合筛选，组合关系为 “且”(即返回数据同时满足多字段条件)。
field	array	否	返回的数据中包含的字段，为空则返回系统用户在市场线索列表设置的显示列
order	string	否	排序参数，示例：{"field_name": "UpdatedDate","sort": "desc"} 支持字段：创建时间，更新时间，具体以后台为准
page_num	int	是	页码
page_size	int	是	每页条数

返回参数说明

参数名称	说明
code	返回码
msg	错误信息
data	数据集

返回码说明

参数名称	说明
-1	系统错误
0	成功
10006	请输入org_id
10007	请输入user_id

请求参数

Query 参数

access_token

string

可选

通过鉴权模块-获取token接口

示例值:

Body 参数application/json

user_id

string

必需

系统用户user_id（控制数据权限，以当前用户权限返回数据。获取方法：1.通过管理员列表接口获取 2.登录系统获取，位置：个人设置-用户ID

condition

array [object {3}]

可选

数据查询条件，为空则返回所有数据。支持多字段组合筛选，组合关系为 “且”(即返回数据同时满足多字段条件)

field_name

string

必需

字段名称，获取方法：1.调用“表结构-表结构详情接口”传入schema_name=“公司” 获取schema_field>child>field_name字段名称。如：系统字段“公司”对应的字段名称“Company”。2.登录系统获取，位置：系统设置-字段-公司对象中字段的“字段名称”。

search_type

string

必需

参数	参数含义
eq	=（等于）
neq	!=（不等于）
like	like（包含）
not_like	not_like （不包含）
not_exist	not_exist（为空）
exist	exist （不为空）
in	in （包含任意）
not_in	not_in （不包含任意）
lt	<（小于）
gt	> （大于）
lte	<=（小于等于）
gte	>=（大于等于）

value

string

可选

字段类型	说明	示例	支持的筛选操作	备注
Text	文本	"hello world"	eq、neq、like、not_like、not_exist、exist	当筛选类型为not_exist、exist时，value不需要传值，其它字段类型同理
TextArea	多行文本	"hello world"	eq、neq、like、not_like、not_exist、exist	---
Email	邮件	"helloworld@qq.com"	eq、neq、like、not_like、not_exist、exist	---
PhoneNumber	手机号	"188xxxxxxxx"	eq、neq、like、not_like、not_exist、exist	---
Select	下拉	"1"	eq、neq、in、not_in、not_exist、exist	调用表结构详情接口，字段options 即为下拉字段的选项，接口传值时使用value。options示例如下: [{"label": "小于100","value": "1"},{"label": "100-200","value": "2"},{"label": "200以上","value": "3"}]
Radio	单选	"1"	eq、neq、in、not_in、not_exist、exist	同下拉
CheckBox	多选	["1","2"]	eq、neq、in、not_in、not_exist、exist	同下拉
DateTime	日期时间	"2023-01-01 00:00:00"	eq、lt、gt、not_exist、exist	---
Date	日期	"2023-01-01"	eq、lt、gt、not_exist、exist	---
Number	数字	"100"	eq、lt、gt、lte、gte、not_exist、exist	---
Decimal	金额	"100.01"	eq、lt、gt、lte、gte、not_exist、exist	---
Address	地址	{province: "10160", city: "100032", area: "101149"}	in、not_in、not_exist、exist	---
Company	公司	"北京致趣科技"	eq、neq、like、not_like、not_exist、exist	---

field

array[string]

需要返回的字段列表

可选

示例：["CorporateName"]

page_num

integer

页码

必需

page_size

integer

每页条数

必需

示例

{
    "user_id": "user8fc4611e750b99432c8dd69e35576b75",
    "condition": [
        {
            "field_name": "CreatedTime",
            "search_type": "gt",
            "value": "2023-08-27 00:00:00"
        }
    ],
    "field": [
        "CorporateName"
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'https://openapi.beschannels.com/leads/open-api/object-list?access_token=uURA1lnYsBr22I6UYoLZH0s9y3HU2Xsn7UHA4dIDgHN_67Z5EZskh4YMcymD5enS4GGjWpOERwQtug3Y4AGwvbvLB_A3TwKBpb_J4z0MUm6oaNQmqA-3Ef9Q-PHbVPk3' \
--header 'Content-Type: application/json' \
--data-raw '{
    "user_id": "user8fc4611e750b99432c8dd69e35576b75",
    "condition": [
        {
            "field_name": "CreatedTime",
            "search_type": "gt",
            "value": "2023-08-27 00:00:00"
        }
    ],
    "field": [
        "CorporateName"
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

返回码

必需

msg

string

错误信息

必需

data

object

数据集

必需

total

integer

返回的数据总数

必需

list

array [object {3}]

返回的数据列表

必需

header

array [object {3}]

返回的数据字段列

必需

schema_id

integer

公司对象表结构ID

必需

示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "total": 2,
        "list": [
            {
                "id": 641,
                "CorporateName": "一起来（武汉）文化传媒有限公司",
                "create_time": 1695107465,
                "modify_time": 1695107999,
                "NumberOfLeads": 0
            },
            {
                "id": 634,
                "CorporateName": "十堰市东风22小学",
                "create_time": 1693289751,
                "modify_time": 1695107436,
                "NumberOfLeads": 0
            }
        ],
        "header": [
            {
                "label": "企业名称",
                "prop": "CorporateName"
            }
        ]
    }
}

公司创建

新增/编辑对象

对象列表

接口描述#

接口调用限制为#

请求参数说明#

返回参数说明#

返回码说明#

请求参数

示例代码

返回响应

接口描述

接口调用限制为

请求参数说明

返回参数说明

返回码说明