验真平台API文档


失联修复匹配结果-平台请求客户

<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>

页面列表

ITEM_HTML