TIP
# 市场活动接口
# 市场活动查询
请求方式: POST(HTTPS)
请求地址: https://openapi.qince.com/api/v2/salesMarkets/query/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:
参数说明:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | INT | 是 | 页数,默认值为1。 |
| rows | INT | 是 | 条数,默认值为100。 |
| sorts | List | 是 | 排序,默认按创建时间倒序排序。 |
| sorts.field_key | VARCHAR(30) | 是 | 排序字段。 |
| sorts.type | VARCHAR(4) | 是 | 排序类型:asc 正序,desc 倒序。 |
| query_group | List | 是 | 查询条件列表 |
| query_group.connector | List | 是 | 组内查询条件,条件AND或OR |
| query_group.filters | VARCHAR(4) | 是 | 组内查询条件 |
| query_group.filters.field_key | VARCHAR(32) | 是 | 字段key |
| query_group.filters.operator | VARCHAR(10) | 是 | 操作符,详见附录操作符说明 (opens new window) |
| query_group.filters.field_values | List | 是 | 字段值集合 |
响应示例:
{
"return_code": "0",
"return_msg": "响应信息",
"msg_id": "{ msg_id }",
"response_data": "<<DATA>>"
}
数据DATA示例:
[
{
"market_expect_income": "",
"market_type_id": "8268931436716426861",
"modify_time": "2025-11-15 15:31:17",
"market_income": "",
"market_cost": "",
"nullify_reason": "",
"market_sales_personnel": "",
"market_expectations": "",
"modifyier_id": "7207043132143939140",
"id": "8319767758810866882",
"market_description": "",
"department": "4909531490615462959",
"exts": [
{
"key" : "field_5IDu0__c",
"value" : "自定义字段值"
}
],
"owner": "7207043132143939140",
"lock_status": "0",
"create_time": "2025-07-28 19:29:46",
"org": "",
"approval_status": "1",
"end_time": "2025-12-28",
"market_site": "",
"source_type": "1",
"market_code": "M2025072800000001",
"market_attache": "",
"start_time": "2025-07-28",
"market_expect_cost": "",
"market_purpose": "",
"market_effect": "",
"name": "确定",
"creator_id": "7772619692568237116",
"market_status": "1",
"status": "1"
}
]
参数说明:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| market_expect_income | VARCHAR | 否 | 预期收入(元) |
| market_type_id | VARCHAR | 否 | 活动类型 |
| modify_time | VARCHAR | 否 | 修改时间 |
| market_income | VARCHAR | 否 | 实际收入(元) |
| market_cost | VARCHAR | 否 | 实际成本(元) |
| nullify_reason | VARCHAR | 否 | 作废原因 |
| market_sales_personnel | VARCHAR | 否 | 销售人员 |
| market_expectations | VARCHAR | 否 | 活动预期 |
| modifyier_id | VARCHAR | 否 | 修改人ID |
| id | VARCHAR | 是 | 市场活动ID |
| market_description | VARCHAR | 否 | 执行描述 |
| department | VARCHAR | 否 | 数据所属部门 |
| exts | List | 否 | 自定义字段列表 |
| exts.key | VARCHAR | 否 | 自定义字段key |
| exts.value | VARCHAR | 否 | 自定义字段value |
| owner | VARCHAR | 否 | 所有者ID |
| lock_status | VARCHAR | 否 | 锁定状态 |
| create_time | VARCHAR | 否 | 创建时间 |
| org | VARCHAR | 否 | 所属组织 |
| approval_status | VARCHAR | 否 | 数据审批标识 |
| end_time | VARCHAR | 否 | 结束时间 |
| market_site | VARCHAR | 否 | 地点 |
| source_type | VARCHAR | 否 | 数据来源 |
| market_code | VARCHAR | 否 | 活动编码 |
| market_attache | VARCHAR | 否 | 活动专员 |
| start_time | VARCHAR | 否 | 开始时间 |
| market_expect_cost | VARCHAR | 否 | 预期成本(元) |
| market_purpose | VARCHAR | 否 | 活动目的 |
| market_effect | VARCHAR | 否 | 效果 |
| name | VARCHAR | 否 | 市场活动名称 |
| creator_id | VARCHAR | 否 | 创建人ID |
| market_status | VARCHAR | 否 | 状态 |
| status | VARCHAR | 否 | 状态 |