open-api
首页
open-api
  • 快速开始
  • 授权登录
  • 客户
  • 销售订单
  • 采购订单
  • 产品
  • 回款登记
  • 回款单
  • 付款单
  • 费用单
  • 报价单
  • 供应商
  • 商机
  • 用户
  • 销售出库单
  • 库存
  • 线索
    • 线索
    • 线索|联系人的数据字典GET
    • 线索列表GET
    • 线索数据查询GET
    • 线索(含联系人)创建/编辑接口POST
  • 资金
  • 采购入库单
  • 采购退货单
  • 统计分析
  • 示例接口(勿用)
  • 阿里账号信息GET
  • 阿里资金账户信息GET
亮色模式
  1. 线索

线索(含联系人)创建/编辑接口

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 个月前