失联修复匹配结果-平台请求客户
<p>[TOC]</p>
<h5>产品描述</h5>
<ul>
<li>当批次的修复状态为修复成功或修复失败时,向客户推送匹配结果</li>
</ul>
<h5>请求发起方</h5>
<ul>
<li>平台</li>
</ul>
<h5>接口地址</h5>
<ul>
<li>请求地址:<code>由客户提供给运营人员进行配置</code></li>
<li>请求方式:POST</li>
<li>接口数据类型:JSON</li>
<li>编码方式:UTF-8</li>
<li>接口参数传递位置:请求体body</li>
</ul>
<h5>请求参数</h5>
<p>验真状态码及描述请查看本页章节 <code>验真状态码及描述</code> 。</p>
<table>
<thead>
<tr>
<th>参数名</th>
<th>是否必填</th>
<th>类型</th>
<th>父元素</th>
<th><div style="width: 400px"/>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>是</td>
<td>string</td>
<td>无</td>
<td>请求返回码,都为000</td>
</tr>
<tr>
<td>messag</td>
<td>是</td>
<td>string</td>
<td>无</td>
<td>请求返回码描述,都为请求成功</td>
</tr>
<tr>
<td>msgid</td>
<td>是</td>
<td>string</td>
<td>无</td>
<td>平台流水号</td>
</tr>
<tr>
<td>billing</td>
<td>是</td>
<td>string</td>
<td>无</td>
<td>是否计费,1:计费;0:不计费</td>
</tr>
<tr>
<td>data</td>
<td>是</td>
<td>json</td>
<td>无</td>
</tr>
<tr>
<td>state</td>
<td>是</td>
<td>string</td>
<td>data</td>
<td>验真状态码</td>
</tr>
<tr>
<td>desc</td>
<td>是</td>
<td>string</td>
<td>data</td>
<td>验真状态码描述</td>
</tr>
<tr>
<td>uploadDataMsgid</td>
<td>否</td>
<td>string</td>
<td>data</td>
<td>平台上传数据流水号,即客户请求的内容</td>
</tr>
<tr>
<td>toRepairCount</td>
<td>否</td>
<td>int</td>
<td>data</td>
<td>待修复数,去重后的有效信息条数</td>
</tr>
<tr>
<td>successCount</td>
<td>否</td>
<td>int</td>
<td>data</td>
<td>修复成功数,即修复成功的授权码中元素数量,即收费数量</td>
</tr>
<tr>
<td>successTime</td>
<td>否</td>
<td>string</td>
<td>data</td>
<td>修复成功时间,格式:yyyy-MM-dd hh:mm:ss</td>
</tr>
<tr>
<td>dueDate</td>
<td>否</td>
<td>string</td>
<td>data</td>
<td>有效到期日,格式:yyyy-MM-dd</td>
</tr>
<tr>
<td>successAuthCodes</td>
<td>否</td>
<td>Json</td>
<td>data</td>
<td>修复成功的授权码,key为客户提交的授权码,value为修复结果归属运营商(1:移动;2:联通;3:电信)</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<p>为保持 平台请求客户 和 客户请求平台 两种方式通知客户的内容相同,故此处仍有 统一响应参数</p>
<h6>修复成功-有数据</h6>
<pre><code>{
"code": "000",
"message": "请求成功",
"msgid": "7894415526266478932",
"billing": "1",
"data": {
"state": "3",
"desc": "修复成功",
"toRepairCount":3,
"successCount":2,
"successTime":"2021-01-20 14:18:02",
"dueDate":"2021-02-20",
"successAuthCodes":{
"authCode1":1,
"authCode2":1
}
}
}</code></pre>
<h6>修复成功-无数据</h6>
<pre><code>{
"code": "000",
"message": "请求成功",
"msgid": "7894415526266478932",
"billing": "1",
"data": {
"state": "3",
"desc": "修复成功",
"toRepairCount":3,
"successCount":0,
"successTime":"2021-01-20 14:18:02",
"dueDate":"2021-02-20",
"successAuthCodes":{}
}
}</code></pre>
<h6>修复失败</h6>
<pre><code>{
"code": "000",
"message": "请求成功",
"msgid": "7894415526266400000",
"billing": "0",
"data": {
"state": "4",
"desc": "修复失败"
}
}</code></pre>
<h5>客户响应参数(data)</h5>
<table>
<thead>
<tr>
<th>参数名</th>
<th>是否必填</th>
<th>类型</th>
<th><div style="width: 400px"/>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>是</td>
<td>string</td>
<td>处理状态码,000表示客户处理成功,其余表示处理失败<br/>客户处理成功,平台将不再回调,否则会在5分钟后进行第二次回调,若依然失败,将在10分钟后进行第三次回调,若依然失败,平台将不再回调</td>
</tr>
</tbody>
</table>
<h5>客户响应示例</h5>
<h6>处理成功</h6>
<pre><code>{
"code":"000"
}</code></pre>
<h6>处理失败</h6>
<pre><code>{
"code":"999"
}</code></pre>
<h5>验真状态码及描述</h5>
<table>
<thead>
<tr>
<th>验真状态码(state)</th>
<th>验真状态码描述(desc)</th>
<th>是否收费</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>3</td>
<td>修复成功</td>
<td>是</td>
<td>该情况有其他响应参数,根据修复成功的数量和修复结果归属运营商进行收费</td>
</tr>
<tr>
<td>4</td>
<td>修复失败</td>
<td>否</td>
</tr>
</tbody>
</table>
<p>平台只会在得到确定的修复结果后向客户推送匹配结果</p>