新增外联盟 - 尘锋SCRM开放平台

POST https://qw-openapi-tx.dustess.com/external_partner/create?accessToken=

请求header

字段	值
Content-Type	application/json

Params:

字段	类型	描述	是否必须
accessToken	`String`	accessToken	true

请求参数

请求参数名	类型	说明	是否必须
params	`[]Object`	外联盟	true
params.name	`String`	外联盟名称	true
params.phone	`String`	电话号码	true
params.owner	`String`	使用人员工id	true
params.enabled	`bool`	启用状态 true,false	false
params.udf	object	自定义字段	false
params.udf.model_data	object []	自定义字段	false
params.udf.model_data[].key	string	自定义字段id	false
params.company.udf.model_data[].value	string	自定义字段name	false
请求参数示例
`json` - Request-Example:

{
    "params": [
        {
            "name": "测试外联盟",
            "phone": "110101",
            "owner": "144",
            "udf": {
                "model_data": [
                    {
                        "key": "f0ce66-lkroqp0e",
                        "value": null // 代表空值，置空该字段的值
                    },
                    {
                        "key": "tqlcsb-ll4uqr23",
                        "value": "单行/多行传入值" // 单多行文本的值
                    },
                    {
                        "key": "ytwhyh-ll4uqr23",
                        "value": "2023-08-12" // 日期的值
                    },
                    {
                        "key": "wbwsja-ll4uqr23",
                        "value": "2023-08-15 14:00:00" // 时间日期的值
                    },
                    {
                        "key": "c75noa-1h0hsvcb5",
                        "value": "99" // 数字类型传入实例
                    },
                    {
                        "key": "60mdnv-lhen3uic",
                        "value": "[\"1\"]" // 单多选传入实例，单选仅支持传入一个值，多选可传入多个值
                    },
                    {
                        "key": "75yey8-ljze44hq",
                        // 多级联选传入实例，单选仅支持传入一个值，多选可传入多个值；每个值需包含父级选项id，使用「/」分割选项id：一级选项id/二级选项id/三级选项id
                        "value": "[\"1679051431107665933/1679051431107665934\",\"1679051431107665933/1679051431107665934/1679051431107665935/1679051431107665940\"]"
                    },
                    {
                        "key": "ys8xs5-lk0vvuoy",
                        // 附件字段传入实例
                        "value": "[{\"name\":\"企业列表.xlsx\",\"url\":\"https://cdn-member-test.dustess.com/W00000000545/static/l/l/d/9/lld9nnx7p91692084131697.xlsx\",\"size\":11085,\"type\":\"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\"]"
                    }
                ]
            }
        }
    ]
}

成功响应

响应参数名	类型	说明
code	`Int`	响应码，0:成功
msg	`String`	消息提示
success	`Bool`	成功标识
data	`Object`	响应结果
data.ids	`[]String`	创建的外联盟 id
data.results	`[]Object`	创建结果详情
data.results.code	`int64`	错误码
data.results.msg	`String`	错误消息
data.results.extra	`Map<string,string>`	额外信息（key见下文）

extra 可用 key

key	value 说明
repeated_ids	重复ID，`[]String` 的 JSON 编码

成功响应示例

{
    "success": true,
    "code": 0,
    "msg": "",
    "data": {
        "ids": ["1234567"]
    },
    "trace_id": "81d869b0-ae7d-40e4-8d98-a14e6a941852"
}

错误响应示例

{
    "success": false,
    "code": 40020,
    "msg": "param enable error ex:0|1|2",
    "data": {}
}