线索创建（Lead Creation） - jing-openplatform-api

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

接口调用限制为：
每秒10次；每天10000次

Interface Description:
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

Interface calls are limited to:
10 times per second; 10,000 times per day

请求参数

Header 参数

app_id

string

应用id

必需

默认值:

access_token

string

应用密钥

必需

默认值:

Body 参数application/json

business_type

string

必需

业务类型(通过《获取业务类型》接口获取：外层的jing_uuid字段)

（English）business type (obtained through the "Get Business Type" interface: the outer jing_uuid field)

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

最新微站页面名称

（English）the latest microsite page name

source_custom_param

string

可选

最新自定义来源字段

（English）the latest custom source field

owner

string

负责人id

可选

示例

{
  "business_type": "string",
  "mobile": "string",
  "email": "string",
  "name": "string",
  "first_name": "string",
  "last_name": "string",
  "lead_status": "string",
  "account_id": "string",
  "company_id": "string",
  "official_website": "string",
  "industry": "string",
  "title": "string",
  "country_region": "string",
  "address": "string",
  "description": "string",
  "latest_remark": "string",
  "department": "string",
  "param_1": "string",
  "param_2": "string",
  "param_3": "string",
  "param_4": "string",
  "param_5": "string",
  "utm_source": "string",
  "utm_medium": "string",
  "utm_terms": "string",
  "utm_campaign": "string",
  "utm_content": "string",
  "source_type": "string",
  "source_name": "string",
  "website_name": "string",
  "website_page_name": "string",
  "source_custom_param": "string",
  "owner": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

request_id

string

必需

请求唯一id

（English）request unique id

code

integer

必需

成功返回0

（English）success then return 0

msg

string

success

必需

data

object

必需

jing_uuid

string

必需

线索id

（English）lead id

示例

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