新增/编辑线索
POST
/leads/open-api/edit-leads接口描述
新增&更新市场线索
注:此接口至少需要一个身份标识(线索id或手机号(首要身份识别字段))。如果同时传入, 线索id优先级最高。
新增/更新市场线索的字段名称获取方式:
- 方式1:致趣后台管理页面查看位置为:系统设置-字段-市场线索对象中字段的“字段名称” 。
- 方式2:调用“表结构-表结构详情接口”传入schema_name=“市场线索” 获取schema_field>child>field_name字段名称。如:系统字段“公司”对应的字段名称“Company”。
请求参数说明
参数名称 | 参数类型 | 必须 | 说明 |
---|---|---|---|
user_id | string | 是 | 系统用户的user_id,获取方法:1.通过 管理员列表接口 获取 2.登录系统获取,位置:个人设置-用户ID |
leads_id | int | 否 | 线索ID |
MobilePhone | string | 否 | 市场线索手机号(首要身份识别字段) |
请求体-字段值传递说明
字段类型 | 说明 | 示例 | 备注 |
---|---|---|---|
Text | 文本 | "hello world" | |
TextArea | 多行文本 | "hello world" | |
邮件 | "helloworld@qq.com" | ||
PhoneNumber | 手机号 | "188xxxxxxxx" | |
Select | 下拉 | "小于100" | 调用表结构详情接口,字段options 即为下拉字段的选项,接口传值时使用字段选项值的显示名称(label)。options示例如下: [{"label": "小于100","value": "1"},{"label": "100-200","value": "2"},{"label": "200以上","value": "3"}] |
Radio | 单选 | "小于100" | 同下拉 |
CheckBox | 多选 | "小于100","100-200" | 多个选项使用 , 分割 |
DateTime | 日期时间 | "2023-01-01 00:00:00" | |
Date | 日期 | "2023-01-01" | |
Number | 数字 | "100" | --- |
Decimal | 金额 | "100.01" | |
Address | 地址 | --- | |
Company | 公司 | "北京致趣科技" |
Address地址类型传输省市区ID,以|分割。示例:10161|100050(北京|朝阳),10169|100197(河北|邯郸)
请求参数
Query 参数
Body 参数application/json
user_id
string
用户ID
具体说明参考:开发指南-通用项&参数说明
is_add
string
是否新增
0 新增编辑 1新增 2编辑
leads_id
integer
线索ID
leads_id,首要身份识别字段不能同时为空
MobilePhone
string
手机号
leads_id,首要身份识别字段不能同时为空
Email
string
邮件
示例数据:邮箱
FullName
string
姓名
示例数据:姓名
Company
string
公司
示例数据:公司
member_23182
string
示例数据:日期时间
member_23181
string
示例数据:日期
Address
string
示例数据:地址
member_23177
string
示例数据:单选
member_23178
string
示例数据:多选
示例
{
"user_id": "usercd4adfcb940f4aad4785ca60f2b34aad",
"MobilePhone": "13499998765",
"FullName": "13499998765-api",
"Email": "13499998765@qq.com",
"member_23182": "2023-11-05 00:00:00",
"member_23181": "2023-11-05",
"Address": "10169|100197|101771",
"member_23177": "A",
"member_23178": "a,b"
}
示例代码
返回响应
请求成功(200)
失败请求(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
code
integer
必需
状态值 0 成功,其他失败
msg
string
状态码描述
data
array [object {5}]
必需
client_info
string
可选
首要身份识别字段信息
type
integer
可选
leads_id
integer
线索ID
customer_id
string
可选
customer_id
operate_type
string
可选
新增/更新标识,add新增 update更新
示例
{
"code": 0,
"msg": "成功",
"data": [
{
"client_info": "13499998765",
"type": 1,
"leads_id": 10389953,
"customer_id": "a9ecf4ad-f6cc-41eb-0f69-831a9b733c40",
"operate_type": "add"
}
]
}
修改于 6 个月前