线索更新（Lead Update）

live-阿里云（Alibaba Cloud）

https://jingopenapi.jingsocial.com

POST

/v1/leads/update

如需操作自定义属性，则通过调用《获取对象所有字段》接口来获取相关属性code，自定义属性与预设字段同级。
接口返回的is_preset=0是自定义字段，is_preset=1是预设字段。
预设字段即标准字段可操作属性看该接口文档。
自定义字段的type为department, multi_departmemt, image, look_up的不能创建或更新。
如果上传字段为空，则置空；如果不传字段，或字段值为“Null”，则不影响。

If you need to operate custom attributes, you can get the relevant attribute code by calling the "Get all fields of an object" interface. The custom attributes are at the same level as the preset fields.
The interface returns is_preset=0 is a custom field and is_preset=1 is a preset field.
The operable attribute of the preset fields i.e. standard fields should refer to the interface documentation.
The type of the custom field is department, multi_ departmemt, image, look_up cannot be created or updated.
If the upload field is empty, leave the lead empty. If the field value is not uploaded, or field value is "NULL", it does not affect the value.

请求参数

Header 参数

app_id

string

应用id

必需

默认值:

access_token

string

应用密钥

必需

默认值:

Body 参数application/json

jing_uuid

string

必需

线索jing_uuid

（English）lead jing_uuid

fields

object

必需

mobile

string

可选

手机号（和邮箱只要有一个有值就行）

（English）mobile (and email as long as one of them has a value)

string

可选

邮箱（和手机号只要有一个有值就行）

（English）email (and mobile as long as one of them has a value)

name

string

可选

姓名

（English）name

first_name

string

可选

名

（English）first name

last_name

string

可选

姓

（English）last name

lead_status

string

可选

线索状态（通过《获取线索状态列表》获取）

（English）lead status (obtained through "Source Field Type (get dropdown options)")

account_id

string

可选

所属客户（用过《获取对象实体列表》）

（English）affiliated account (used "Obtain Object Entity List")

company_id

string

可选

公司名称（非id）

（English）company name (non-id)

official_website

string

可选

公司官网

（English）company official website

industry

string

可选

行业

（English）industry

title

string

可选

职务

（English）title

country_region

string

可选

国家／地区（选项集）（通过《获取选项集字段》获取：取最内层child的jing_uuid）

（English）country / region (option set) (obtained through "Get Option Set Field": take the innermost child's jing_uuid)

address

string

可选

详细地址

（English）detailed address

description

string

可选

描述

（English）description

latest_remark

string

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://jingopenapi.jingsocial.com/v1/leads/update' \
--header 'app_id;' \
--header 'access_token;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "jing_uuid": "",
  "fields": {
    "business_type": "",
    "mobile": "",
    "email": "",
    "name": "",
    "first_name": "",
    "last_name": "",
    "lead_status": "",
    "account_id": "",
    "company_id": "",
    "official_website": "",
    "industry": "",
    "title": "",
    "country_region": "",
    "address": "",
    "description": "",
    "latest_remark": "",
    "department": "",
    "param_1": "",
    "param_2": "",
    "param_3": "",
    "param_4": "",
    "param_5": "",
    "utm_source": "",
    "utm_medium": "",
    "utm_terms": "",
    "utm_campaign": "",
    "utm_content": ""
  }
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

data

object

必需

jing_uuid

string

必需

msg

string

必需

request_id

string

必需

示例

{
    "code": 0,
    "data": {
        "jing_uuid": "string"
    },
    "msg": "string",
    "request_id": "string"
}

🟢200成功

🟢200失败

修改于 2025-06-04 11:00:43

线索创建（Lead Creation）

线索查询（Lead Query）