open-api
首页
首页
  1. 线索
  • 快速开始
  • 授权登录
    • 授权登录流程
    • 鉴权接口
      POST
    • 刷新令牌接口
      POST
  • 客户
    • 客户
    • 跟进动态查询接口
      GET
    • 提交跟进动态
      POST
    • 客户分组新增/编辑
      POST
    • 删除客户分组
      POST
    • 客户阶段新增/编辑
      POST
    • 删除客户阶段
      POST
    • 客户标签新增/编辑
      POST
    • 删除客户标签
      POST
    • 客户枚举:客户类型,客户标签,时区,规模,星级,采购意向,采购额度,职级
      GET
    • 移入公海
      POST
    • 客户数据字典
      GET
    • 客户(含联系人)新增/编辑
      POST
    • 删除客户(仅支持公海客户)
      POST
    • 客户详情
      GET
    • 查询客户的阶段、分组、状态、地区、主营产品、来源
      GET
  • 销售订单
    • 销售订单
    • 销售订单枚举:货币,付款方式,国家/地区,订单类型,订单状态,订单创建方式
      GET
    • 销售订单字段
      GET
    • 销售订单删除
      POST
    • 销售订单新建/编辑
      POST
    • 销售订单列表
      GET
    • 销售订单详情
      GET
  • 采购订单
    • 采购订单
    • 采购订单列表
    • 采购订单字段
    • 采购订单状态
    • 采购订单新增/编辑
    • 采购订单详情
  • 产品
    • 产品
    • 产品枚举:产品类型,离岸价设置类型,创建方式,产品计量单位
    • 产品分组删除
    • 查询产品库列表
    • 产品新建/编辑
    • 产品库的数据字典
    • 产品详情
    • 产品分组新增/编辑
    • 删除产品规格
    • 查询产品分组
    • 新增/编辑规格
    • 查询产品规格列表
    • 增量更新产品规格值
  • 回款登记
    • 回款登记
    • 回款登记详情
    • 回款登记字段
    • 回款登记新建/编辑
    • 回款登记列表
    • 回款登记核销
  • 回款单
    • 回款单
    • 回款方式枚举
    • 回款单列表
    • 回款单字段
    • 回款单新建/编辑
    • 回款单详情
  • 付款单
    • 付款单
    • 付款单详情
    • 付款单字段
    • 付款单列表
  • 费用单
    • 费用单
    • 费用单-详情
    • 费用单字段
    • 费用项目列表
    • 费用单列表
  • 报价单
    • 报价单
    • 报价单列表
    • 报价单状态、币种查询
    • 报价单删除
    • 报价单数据字典
    • 报价单新建/编辑
    • 查询报价单详情
  • 供应商
    • 供应商
    • 供应商列表
    • 供应商字段
    • 供应商删除
    • 供应商详情
    • 供应商新增/编辑
  • 商机
    • 商机
    • 查询商机的销售流程 商机阶段 输单原因
    • 商机删除接口
    • 商机列表
    • 商机数据查询
    • 商机数据字典
    • 商机新建/编辑接口
  • 用户
    • 用户
    • 用户部门列表
    • 用户部门详情
    • 用户列表
    • 用户详情
  • 销售出库单
    • 销售出库单
    • 销售出库单列表
    • 销售出库单详情
    • 销售出库单字段
    • 销售出库单删除
    • 新增/编辑销售出库单
  • 库存
    • 库存
    • 库存写入
    • 仓库查询
  • 线索
    • 线索
    • 线索|联系人的数据字典
      GET
    • 线索列表
      GET
    • 线索数据查询
      GET
    • 线索(含联系人)创建/编辑接口
      POST
  • 资金
    • 资金
    • 资金账户列表
  • 采购入库单
    • 采购入库单
    • 采购入库单-列表
    • 采购入库单-详情
    • 采购入库单字段
    • 采购入库单-删除
    • 采购入库单-新建/编辑
  • 采购退货单
    • 采购退货单
    • 采购退货单-列表
    • 采购退货单-详情
    • 采购退货单字段
    • 采购退货单-新建/编辑
    • 采购退货单-删除
  • 统计分析
    • 统计报告-统计详细
  • 示例接口(勿用)
    • 示例说明
    • 例子列表
    • 例子枚举值查询
  • devops相关
    • 钉钉回调
    • tapd回调接口
    • 获取智齿token
    • 智齿刷新接口
    • app版本发布
    • 钉钉管理-删除账号
  • 动态
  • 阿里账号信息
    GET
  • 阿里资金账户信息
    GET
  • ACP网关接口
    POST
  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 参数

Body 参数application/json

示例
{
        "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
        }]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-sandbox.xiaoman.cn/v1/lead/push' \
--header 'Authorization: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxMWMxMzU5NmRlMGJjYzM1MzRlYTIxMWEyMTE0MTdjODcxZjMzZGVjNjVmMzE1MDcxM2EwMTE5N2I0NGJlODY2NDM0YWFmYjczZmI0ZWIwYiIsImp0aSI6IjZiYzJkMjgxNGVkZDMyNTU2YWFmYTUwNzhhMDRkYzFkYmUxYjcyODU3ZmJjNmYwNDIxMWFiYTYzYTlhMjYwMmU4NzJlMTMyYjZmOGM2Njg0IiwiaWF0IjoxNzE0MDQ1Nzk0LjQ2OTIwNywibmJmIjoxNzE0MDQ1Nzk0LjQ2OTIwOSwiZXhwIjoxNzE0MDcyMDAzLCJzdWIiOiIiLCJzY29wZXMiOlsicHJvZHVjdCIsImNvbXBhbnkiLCJpbnZvaWNlcyIsImxlYWQiLCJvcHBvcnR1bml0eSIsInVzZXIiLCJzdXBwbGllciIsIndhcmVob3VzZSIsInJlcG9ydCIsInB1cmNoYXNlT3JkZXIiLCJjYXBpdGFsQWNjb3VudCJdfQ.Z4euFldG7vO4IXjBIX26LqDBiArdS392llP-RdOucPwEaRsYjNSlsY69veGOqlpsDIvb_W9VpU1pRGMlH-Z8I31oVgZIa7v7Ey8wGeAxGgUI9AVOnb7nhQ25X8Gf8aJQzfMm0IVD3oEGzjyBrO9XciUwuFsq1HdWcm1riPh9DZ_5yIGVsx9V7oZT4pi0VlCf2DjpfuN9q4kkzW7X-UDLfoZIn6HNVS0Yz_BepTtmz7uibRyYjtC1ZhPCs314-bn2qq0k_Ft0_zWAPGCIsYnvZhDJB_1Tz0pKa5hVL6lRmiIDFbEyionLjKFgGOejtv0p0WU2opzDU_lyyGl-whjo8A' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
        "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成功
application/json
Body

示例
{
    "code": 200,
    "message": "success",
    "now": "2025-03-07 15:52:42",
    "data": {
        "lead_id": 5203689291
    }
}
修改于 2025-04-24 06:04:46
上一页
线索数据查询
下一页
资金