===== 绑定关系 =====
====添加绑定关系====
**调用地址**
POST /api/v1/user/relationship/cid.json
**请求参数**
^名称 ^类型 ^必需的 ^注释 ^
|cId |int |是 |联系人ID|
|openId |string |是 |第三方系统用户唯一ID|
|appId |string |否 |绑定微信时微信公众号id|
|account_source |string |是 |绑定账号来源 dingding/wechat/workWechat/open|
**调用者权限**
所有客服
**调用示例**
curl -v -u {account}:{password} https://www.bangwo8.com/api/v1/user/relationship/cid.json \
-H "Content-Type: application/json" -X POST -d '{"cId":"6862715","openId":"564354327","appId":"789","account_source":"wechat"}'
**返回值示例**
成功时:
{
"data": true,
"msg": "success"
}
当联系人不存在时报错:
{
"state": "403",
"message": "user error"
}
当联系人存在但已经有绑定关系时报错:
{
"state": "403",
"message": "Bind Already exists"
}
====查询绑定关系====
**调用地址**
GET /api/v1/user/relationship/cid.json
**请求参数**
^名称 ^类型 ^必需的 ^注释 ^
|cId |int |cId与openId至少用一个参数,两个参数都存在时,绑定关系对应才返回相应值 |联系人ID|
|openId |string |::: |第三方系统用户唯一ID|
|account_source |string |是 |绑定账号来源 dingding/wechat/open|
**调用者权限**
所有客服
**调用示例**
curl https://www.bangwo8.com/api/v1/user/relationship/cid.json?cId=30851821&account_source=dingding&openId=10014850
-v -u {account}:{password}
**返回值示例** \\
成功响应:
{
"data": [
{
"aId": "601993",
"cId": "30851821",
"account": "u2_601993_15cdbc98048f7c059b24f6f3f2065bbd",
"remark": "",
"templateId": "0",
"openId": "10014850",
"appId": "",
"account_source": "dingding"
}
],
"msg": "success"
}
失败响应:
{
"state": "403",
"message": "user error"
}
====修改绑定关系====
**调用地址**
PUT /api/v1/user/relationship/cid.json
**请求参数**
^名称 ^类型 ^必需的 ^注释 ^
|cId |int |是 |联系人ID|
|openId |string |否 |第三方系统用户唯一ID|
|account_source |string |是 |绑定账号来源 dingding/wechat/open|
|appId |string |否 |微信公众号id|
**调用示例**
curl https://www.bangwo8.com/api/v1/user/relationship/cid.json \
-H "Content-Type: application/json" \
-d '{
"cId": "40713895",
"account_source": "wechat",
"openId": "12345",
"appId": "123"
}' \
-v -u {account}:{password} -X PUT
**返回值示例** \\
成功响应:
{
"data": true,
"msg": "success"
}
====删除绑定关系====
**调用地址**
DELETE /api/v1/user/relationship/cid.json
**请求参数**
^名称 ^类型 ^必需的 ^注释 ^
|cId |int |是 |联系人ID|
|account_source |string |是 |绑定账号来源 dingding/wechat/open|
Content-Type: multipart/form-data
**调用示例**
curl -v -u {account}:{password} https://www.bangwo8.com/api/v1/user/relationship/cid.json?account_source=wechat&cId=6862715 \
-H "Content-Type: multipart/form-data"
-X DELETE
**返回值示例**
{
"data": true,
"msg": "success"
}