===== 绑定关系 =====
====添加绑定关系====
**调用地址**
<code>
POST /api/v1/user/relationship/cid.json
</code>

**请求参数**
^名称               ^类型     ^必需的     ^注释 ^
|cId                |int      |是         |联系人ID|
|openId             |string   |是         |第三方系统用户唯一ID|
|appId              |string   |否         |绑定微信时微信公众号id|
|account_source     |string   |是         |绑定账号来源 dingding/wechat/workWechat/open|

**调用者权限**
<code>
所有客服
</code>

**调用示例**
<code>
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"}'
</code>

**返回值示例**
成功时：
<code>
{
    "data": true,
    "msg": "success"
}
</code>

当联系人不存在时报错：
<code>
{
    "state": "403",
    "message": "user error"
}
</code>

当联系人存在但已经有绑定关系时报错：
<code>
{
    "state": "403", 
    "message": "Bind Already exists" 
}
</code>

====查询绑定关系====
**调用地址**
<code>
GET /api/v1/user/relationship/cid.json
</code>

**请求参数**
^名称               ^类型     ^必需的     ^注释 ^
|cId                |int      |cId与openId至少用一个参数，两个参数都存在时，绑定关系对应才返回相应值     |联系人ID|
|openId             |string   |:::         |第三方系统用户唯一ID|
|account_source     |string   |是         |绑定账号来源 dingding/wechat/open|

**调用者权限**
<code>
所有客服
</code>

**调用示例**
<code>
curl https://www.bangwo8.com/api/v1/user/relationship/cid.json?cId=30851821&account_source=dingding&openId=10014850
  -v -u {account}:{password}
</code>

**返回值示例**  \\
成功响应：
<code>
{
    "data": [
        {
            "aId": "601993",
            "cId": "30851821",
            "account": "u2_601993_15cdbc98048f7c059b24f6f3f2065bbd",
            "remark": "",
            "templateId": "0",
            "openId": "10014850",
            "appId": "",
            "account_source": "dingding"
        }
    ],
    "msg": "success"
}
</code>

失败响应：
<code>
{
   "state": "403", 
 
   "message": "user error" 
 
}
</code>

====修改绑定关系====
**调用地址**
<code>
PUT /api/v1/user/relationship/cid.json
</code>

**请求参数**
^名称               ^类型     ^必需的     ^注释 ^
|cId                |int      |是         |联系人ID|
|openId             |string   |否         |第三方系统用户唯一ID|
|account_source     |string   |是         |绑定账号来源 dingding/wechat/open|
|appId              |string   |否         |微信公众号id|

**调用示例**
<code>
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
</code>

**返回值示例**  \\
成功响应：
<code>
{
    "data": true,
    "msg": "success"
}
</code>

====删除绑定关系====
**调用地址**
<code>
DELETE /api/v1/user/relationship/cid.json
</code>

**请求参数**
^名称               ^类型     ^必需的     ^注释 ^
|cId                |int      |是         |联系人ID|
|account_source     |string   |是         |绑定账号来源 dingding/wechat/open|
Content-Type： multipart/form-data

**调用示例**
<code>
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
</code>
**返回值示例**  
<code>
{
    "data": true,
    "msg": "success"
}
</code>