API开放平台

TIP

# 开放接口API说明-投诉反馈相关

# 推送接口

接口说明：推送投诉反馈相关信息。 请求方式： POST（HTTPS）
请求地址： 第三方服务接口URL
请求参数：

参数名称 参数值
msgId 消息ID
dataId 数据ID
dataVersion 接口数据版本，如：001
dataFormat 数据格式：json
dataSource 数据来源。biz：业务功能产生，api：开放接口产生
timestamp 请求时间戳，如：1503276678552
status 数据同步状态。0：数据首次同步，2：数据失败同步
statusTime 上次同步失败时间。格式：yyyy-MM-dd HH:mm:ss
tenantId 企业ID，各注册企业在勤策中对应的唯一ID
digest 数据签名，md5(data|pushsecret|timestamp)
dataType customer_suggest
data <<请求数据体>> ，说明：格式为JSON格式数据

请求数据体：

{
    "complainId": "8882305777016628188",
    "customerId": "4678348326854106720",
    "customerName": "客户名称",
    "complaintsDetails": "投诉反馈",
    "complainTime": "2022-06-23 13:43:57"
}

参数说明：

参数 类型 必填 说明
complainId VARCHAR(32) 是 投诉反馈ID
customerId VARCHAR(32) 是 客户ID
customerName VARCHAR(100) 是 客户名称
complaintsDetails VARCHAR(4000) 是 反馈内容
complainTime VARCHAR(32) 是 反馈时间

响应示例：

{
 "return_code": 0,
 "return_msg": ""
}

参数说明：

参数 类型 说明
return_code int 响应编码。0：成功，1：失败
return_msg String 响应说明

# 投诉反馈回复

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/custComplaint/v1/replaycomplaint/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "complainId": "8882305777016628188",
    "replayDetails": "投诉反馈回复"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
complainId VARCHAR(100) 是 投诉反馈ID
replayDetails VARCHAR(4000) 是 投诉反馈回复内容

响应示例：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

异常示例：

{
    "msg_id": "X000001",
    "return_code": 1,
    "return_msg": "当前投诉已解决"
}

参数说明：

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明

← 幸运抽奖接口 →