19.1 联系人单条创建

POST

https://openapi.weiling.cn/openapi/contact/create

请求参数

Query 参数

access_token

string

接口调用凭证

可选

Body 参数application/json

user_name

string

联系人名称

必需

contact_ways

array [object {2}]

联络方式

必需

type

integer

可选

联络方式类型（1-手机号 2-座机 3-邮箱）

contact_way

string

联络方式具体信息

可选

create_time

integer

创建时间

可选

status

integer

必需

联系人状态（0-待认领（公海）、1-已认领、4-待分配）

create_user_id

string

创建人

必需

owner_id

string

归属人

可选

sea_id

string

可选

公海id（联系人状态为0时不为空，默认为默认公海）

gender

integer

可选

性别（0 未选择 1 男 2 女）

age

integer

年龄

可选

>= 0<= 200

corp_name

string

公司名称

可选

corp_address

string

公司地址

可选

register_address

string

注册地址

可选

population_size

integer

可选

公司规模
0：0-19人
1：20-99人
2：100-499人
3：500-999人
4：1000-9999人
5：10000人以上

industry

string

行业

可选

legal_person

string

法人

可选

string

邮箱

可选

group_name

string

推广组

可选

key_word

string

关键词

可选

plan_name

string

推广计划

可选

creative_title

string

创意标题

可选

creative_description

string

创意描述

可选

advertiser_account_name

string

推广账户

可选

string

QQ号

可选

region

string

地域

可选

url

string

URL

可选

searchword

string

搜索词

可选

wx_id

string

微信id

可选

from_channel_id

number

可选

来源（默认其他-其他）其他值通过https://www.apifox.cn/apidoc/shared/19699d3b-8e70-434a-b516-ce35107d2094/api-249167310 接口获取

contact_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 接口获取；
如没有，请联系小微配置。

示例

{
    "user_name": "汤刚",
    "contact_ways": [
        {
            "type": 86,
            "contact_way": "ut minim"
        },
        {
            "type": 82,
            "contact_way": "veniam aute adipisicing"
        }
    ],
    "create_time": 1713887878644,
    "status": 32,
    "create_user_id": "65",
    "owner_id": "76",
    "sea_id": "72",
    "gender": 39,
    "age": 5,
    "corp_name": "都状论",
    "corp_address": "河南省长口市静安区",
    "register_address": "北京市太南市宁安市",
    "population_size": 65,
    "industry": "sit in",
    "legal_person": "cillum amet minim",
    "email": "ggqlnf_jd4@qq.com",
    "group_name": "门区现",
    "key_word": "reprehenderit",
    "plan_name": "图于点",
    "creative_title": "才报难",
    "creative_description": "dolor",
    "advertiser_account_name": "会断石",
    "qq": "ex deserunt dolore aute anim",
    "region": "Duis",
    "url": "https://spotless-traditionalism.net",
    "searchword": "ex veniam",
    "wx_id": "72",
    "from_channel_id": "56",
    "contact_custom": {}
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.weiling.cn/openapi/contact/create?access_token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "user_name": "汤刚",
    "contact_ways": [
        {
            "type": 86,
            "contact_way": "ut minim"
        },
        {
            "type": 82,
            "contact_way": "veniam aute adipisicing"
        }
    ],
    "create_time": 1713887878644,
    "status": 32,
    "create_user_id": "65",
    "owner_id": "76",
    "sea_id": "72",
    "gender": 39,
    "age": 5,
    "corp_name": "都状论",
    "corp_address": "河南省长口市静安区",
    "register_address": "北京市太南市宁安市",
    "population_size": 65,
    "industry": "sit in",
    "legal_person": "cillum amet minim",
    "email": "ggqlnf_jd4@qq.com",
    "group_name": "门区现",
    "key_word": "reprehenderit",
    "plan_name": "图于点",
    "creative_title": "才报难",
    "creative_description": "dolor",
    "advertiser_account_name": "会断石",
    "qq": "ex deserunt dolore aute anim",
    "region": "Duis",
    "url": "https://spotless-traditionalism.net",
    "searchword": "ex veniam",
    "wx_id": "72",
    "from_channel_id": "56",
    "contact_custom": {}
}'

返回响应

🟢200成功

application/json

Body

msg

string

必需

code

integer

必需

data

object

必需

contact_id

string

联系人id

必需

示例

成功示例异常示例

{
    "msg": "success",
    "code": 0,
    "data": {
        "contact_id": "d3IYZxaC7tq7u1NkzFbb3TNAC0OcrIcmW9UxSM51pUA"
    }
}

修改于 2025-06-12 03:37:15

18.2 查询个微人脉详情

19.2 批量获取联系人详情