# 市场活动接口

# 市场活动查询

请求方式: POST(HTTPS
请求地址: https://openapi.qince.com/api/v2/salesMarkets/query/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

 {
  "sorts" : [
    {
      "field_key" : "create_time",
      "type" : "desc"
    }
  ],
  "page" : 1,
  "rows" : 100,
  "query_group" : [
    {
      "connector" : "and",
      "filters" : [
        {
          "field_key" : "market_status",
          "operator" : "EQ",
          "field_values" : ["1"]
        }
      ]
    }
  ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
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 状态