亮色模式
线索(含联系人)创建/编辑接口
POST
/v1/lead/push| 异常码 | 异常消息 |异常解决方案|
| 404 | Input data validate error origin_list must be array | 检查传入的origin_list是否是数组 |
| 404 | Not Found Resource | 检查传入的lead_id是否存在 |
| 400 | Invalid data json | 检查传入的数据是否是json格式 |
| 400 | Empty POST request body data | 检查传入的数据是否为空 |
请求参数
Header 参数
Authorization
string
必需
示例值:
eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxMWMxMzU5NmRlMGJjYzM1MzRlYTIxMWEyMTE0MTdjODcxZjMzZGVjNjVmMzE1MDcxM2EwMTE5N2I0NGJlODY2NDM0YWFmYjczZmI0ZWIwYiIsImp0aSI6IjZiYzJkMjgxNGVkZDMyNTU2YWFmYTUwNzhhMDRkYzFkYmUxYjcyODU3ZmJjNmYwNDIxMWFiYTYzYTlhMjYwMmU4NzJlMTMyYjZmOGM2Njg0IiwiaWF0IjoxNzE0MDQ1Nzk0LjQ2OTIwNywibmJmIjoxNzE0MDQ1Nzk0LjQ2OTIwOSwiZXhwIjoxNzE0MDcyMDAzLCJzdWIiOiIiLCJzY29wZXMiOlsicHJvZHVjdCIsImNvbXBhbnkiLCJpbnZvaWNlcyIsImxlYWQiLCJvcHBvcnR1bml0eSIsInVzZXIiLCJzdXBwbGllciIsIndhcmVob3VzZSIsInJlcG9ydCIsInB1cmNoYXNlT3JkZXIiLCJjYXBpdGFsQWNjb3VudCJdfQ.Z4euFldG7vO4IXjBIX26LqDBiArdS392llP-RdOucPwEaRsYjNSlsY69veGOqlpsDIvb_W9VpU1pRGMlH-Z8I31oVgZIa7v7Ey8wGeAxGgUI9AVOnb7nhQ25X8Gf8aJQzfMm0IVD3oEGzjyBrO9XciUwuFsq1HdWcm1riPh9DZ_5yIGVsx9V7oZT4pi0VlCf2DjpfuN9q4kkzW7X-UDLfoZIn6HNVS0Yz_BepTtmz7uibRyYjtC1ZhPCs314-bn2qq0k_Ft0_zWAPGCIsYnvZhDJB_1Tz0pKa5hVL6lRmiIDFbEyionLjKFgGOejtv0p0WU2opzDU_lyyGl-whjo8A
Body 参数application/json
lead_id
integer
线索ID
编辑时需要设置 值来自于/v1/lead/list接口
user_id
integer
跟进人
不填则默认为创建人 值来自于/v1/user/list接口
name
string
线索名称
company_name
string
客户名称
short_name
string
简称
scale_id
integer
规模ID
值来自/v1/company/companyEnums 接口
group_id
integer
分组ID
从分组v1/company/fields/selector?field=group_id选择
country
string
国家/地区
非必填,ISO两位码
province
string
省
对接需要询问对接协助开发获取省枚举
city
string
市
对接需要询问对接协助开发获取市枚举
tel
string
座机号码
fax
string
传真
origin_list
array[integer]
线索来源
可选字段,从v1/company/fields/selector?field=origin选择
biz_type
integer
客户类型
可选字段 /v1/company/companyEnums
address
string
地址
可选字段
remark
string
备注
可选字段
homepage
string
主页网址
可选字段
customers
array [object {15}]
线索联系人列表
name
string
昵称
email
string
联系人邮箱
如果线索存在该联系人邮箱,则是编辑操作
tel
string
电话号码
tel_area_code
string
电话号码区号
post
string
职位
qq
string
QQ账号
linkedin
string
LinkedIn账号
skype
string
Skype账号
whatsapp
string
WhatsApp账号
facebook
string
Facebook账号
wechat
string
微信账号
twitter
string
Twitter账号
birth
string
生日
remark
string
联系人备注
main_customer_flag
integer
是否主要联系人
0=不是,1=是主要联系人
示例
{
"lead_id": 0,
"name": "线索B1",
"company_name": "小满科技",
"short_name": "简称",
"scale_id": 2,
"group_id": 1345,
"origin_list": [
14
],
"biz_type": "生产商",
"country": "CN",
"province": "江西省",
"city": "赣州市",
"address": "章贡街道",
"homepage": "zhanggong.com",
"remark": "备注",
"user_id": 11858713,
"fax": "234345",
"tel": "345436",
"customers": [
{
"name": "线索联系人测试3",
"main_customer_flag": 1,
"email": "sdfdsadf2d3f@163.com",
"birth": "1908-09-09",
"post": "部门经理",
"remark": "联系人备注",
"tel": "345436",
"tel_area_code": "86",
"qq": "234345456",
"linkedin": 23453456,
"skype": "34534676",
"whatsapp": "w54346436",
"facebook": "facebook01",
"wechat": "234522qq1",
"twitter": 3453456
}
]
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
code
integer
必需
message
string
必需
now
string
必需
data
object
必需
lead_id
integer
线索ID
示例
{
"code": 200,
"message": "success",
"now": "2025-03-07 15:52:42",
"data": {
"lead_id": 5203689291
}
}
最后修改时间: 3 个月前