电子合同API开发文档 v1

获取联系人列表

接口地址:https://api.1dq.com/v1/Contacts.json

请求方式:POST

参数位置:body

权限控制:支持

接口版本: v1.0

在线工具:API在线调试接口

接口描述:
获取账户常用联系人列表

请求参数

除去下列参数中,需要在header中添加公共参数,详见公共请求参数

参数名 是否必填 长度 类型 默认值 描述 示范
limit - INT 15
每页数量
15
name - STRING -
名字搜索
note - STRING -
备注搜索
number - STRING -
号码搜索
18621991212
page - INT 1
分页
1

请求示范

 POST https://api.1dq.com/v1/Contacts.json
 {
    "limit": "15",
    "name": "",
    "note": "",
    "number": "18621991212",
    "page": "1"
}

返回结果

参数名 是否必填 长度 类型 默认值 描述 示范
code 1-10 long 业务状态码 200
msg 2-64 string 结果描述 请求成功
data - 结果集 -

----number

- STRING 手机号或邮箱号

----name

- STRING 姓名

----note

- STRING 备注

成功示范

{
    "code": 200,
    "msg": "success",
    "data": {
        "total": 1,
        "per_page": 15,
        "current_page": 1,
        "last_page": 1,
        "data": [
            {
                "id": "Vk43BEZL2nyj1zLK",
                "user_id": 836254107,
                "number": "18621991212",
                "name": "张三",
                "note": "",
                "create_time": "2020-02-14 20:26:48",
                "update_time": "2020-02-14 20:36:59",
                "delete_time": 0
            }
        ]
    }
}

失败示范

{
    "code": 200,
    "msg": "success",
    "data": {
        "total": 0,
        "per_page": 15,
        "current_page": 1,
        "last_page": 0,
        "data": []
    }
}

状态码

状态码 说明 备注
404 未找到可用数据 -

其他备注

暂无

附件一 接口示范代码