新增/编辑线索

接口描述

新增&更新市场线索
注：此接口至少需要一个身份标识（线索id或手机号(首要身份识别字段)）。如果同时传入，线索id优先级最高。

接口调用限制为

每秒20次。

新增/更新市场线索的字段名称获取方式：

方式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"
Email	邮件	"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	公司	"北京致趣科技"

⚠️注意：初始一级来源，初始二级来源，是系统特殊字段，只传入初始二级来源即可，需要传系统ID，

Address地址类型传输省市区ID,以|分割。示例：10161|100050（北京|朝阳），10169|100197（河北|邯郸）地区编码表：https://img02.ma.scrmtech.com/2351/1064/resource/1709622780/%E5%9C%B0%E5%8C%BA%E4%BF%A1%E6%81%AF.xlsx

请求参数

Query 参数

access_token

string

必需

通过鉴权模块-获取token接口

示例值:

Body 参数application/json

user_id

string

用户ID

必需

具体说明参考：开发指南-通用项&参数说明

is_add

string

是否新增

可选

0 新增编辑 1新增 2编辑

leads_id

integer

线索ID

可选

leads_id，首要身份识别字段（MobilePhone或Email）不能同时为空

MobilePhone

string

手机号

可选

leads_id，首要身份识别字段（MobilePhone或Email）不能同时为空

string

邮件

可选

leads_id，首要身份识别字段（MobilePhone或Email）不能同时为空

FullName

string

姓名

可选

示例数据：姓名

Company

string

公司

可选

示例数据：公司

member_23182

string

示例数据：日期时间

可选

member_23181

string

示例数据：日期

可选

Address

string

示例数据：地址

可选

member_23177

string

示例数据：单选

可选

member_23178

string

示例数据：多选

可选

示例

{
    "user_id": "",
    "MobilePhone": "13499998765",
    "RelatedCompany": 4495453
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200请求成功

application/json

Body

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"
        }
    ]
}

🟢200失败请求

接口描述#

接口调用限制为#

请求参数说明#

请求体-字段值传递说明#

请求参数

示例代码

返回响应

接口描述

接口调用限制为

请求参数说明

请求体-字段值传递说明