卫瓴API文档

10.3 商机新增-新版

POST

https://openapi.weiling.cn/openapi/v2/business/create

请求参数

Query 参数

access_token

string

可选

Body 参数application/json

business_name

string

商机名称

可选

stage

integer

商机阶段值

必需

company_id

string

企业id

可选

related_customers

array [object {2}]

可选

商机关联的外部相关人

type

integer

0-联系人

可选

ids

array[string]

对象的id列表

可选

user_ids

array[string]

商机协作人

可选

except_amount

integer

预计赢单金额

可选

except_date

string

预计赢单日期

可选

winning_amount

integer

赢单金额

可选

winning_date

string

赢单日期

可选

create_user_id

string

创建人

必需

create_time

number

必需

创建时间,13位时间戳

update_time

number

更新时间

可选

process_id

string

流程id

可选

business_custom

object

可选

商机自定义字段（⚠️如果系统中有字段设置了必填，则需要传此参数）
(key为apiName , value为传参 ;
是日期类型: 13位时间戳 ;
是单选类型: 选项的label值（number） ;
是多选类型: 选项的label值的集合（Array of number） )；
apiName通过https://www.apifox.cn/apidoc/shared/19699d3b-8e70-434a-b516-ce35107d2094/api-249167310 接口获取；
如没有，请联系小微配置。

示例

{
  "business_name": "string",
  "stage": 0,
  "company_id": "string",
  "related_customers": [
    {
      "type": 0,
      "ids": [
        "string"
      ]
    }
  ],
  "user_ids": [
    "string"
  ],
  "except_amount": 0,
  "except_date": "string",
  "winning_amount": 0,
  "winning_date": "string",
  "create_user_id": "string",
  "create_time": 0,
  "update_time": 0,
  "process_id": "string",
  "business_custom": {
    "api_name": "value"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.weiling.cn/openapi/v2/business/create?access_token' \
--header 'Content-Type: application/json' \
--data-raw '{
  "business_name": "string",
  "stage": 0,
  "company_id": "string",
  "related_customers": [
    {
      "type": 0,
      "ids": [
        "string"
      ]
    }
  ],
  "user_ids": [
    "string"
  ],
  "except_amount": 0,
  "except_date": "string",
  "winning_amount": 0,
  "winning_date": "string",
  "create_user_id": "string",
  "create_time": 0,
  "update_time": 0,
  "process_id": "string",
  "business_custom": {
    "api_name" : "value"
  }
}'

返回响应

🟢200成功

application/json

Body

code

string

可选

msg

string

可选

data

object

可选

business_id

string

商机id

可选

示例

{
  "code": "string",
  "msg": "string"
}

修改于 2025-04-25 07:28:20

10.3 商机创建（即将废弃）

10.4 商机更新