失联修复绑定中间号(lost_repair_bind_virtual_number)
<p>[TOC]</p>
<h5>产品描述</h5>
<ul>
<li>通过输入的平台上传数据流水号、主叫号码、授权码返回中间号</li>
</ul>
<h5>接口地址</h5>
<ul>
<li>请求地址:<code>https://api.caih.com/verify/api/lost_repair_bind_virtual_number</code></li>
<li>请求方式:POST</li>
<li>接口数据类型:JSON</li>
<li>编码方式:UTF-8</li>
<li>接口参数传递位置:请求体body</li>
<li>接口参数传递内容:认证信息参数(authinfo)和校验请求参数(param)</li>
</ul>
<h5>接口须知</h5>
<ul>
<li><strong>认证信息参数</strong> 和 <strong>统一响应参数</strong>请查看页面 <a href="https://www.showdoc.cc/p/52021eddfd9994a7b84d891a16e27f66" title="认证信息参数和统一响应参数">认证信息参数和统一响应参数</a></li>
<li>如需加密对接请查看页面 <a href="https://www.showdoc.cc/p/dfff667dec3c68748dddde67674eb993" title="加密对接说明">加密对接说明</a>,并联系运营人员进行配置</li>
</ul>
<h5>请求时间限制</h5>
<ul>
<li>每天的 8:00:00-21:30:00 可以请求</li>
<li>当前日期超过上传数据批次的有效到期日(失联修复匹配结果接口响应内容的dueDate字段)后不可请求</li>
</ul>
<h5>校验请求参数(param)</h5>
<table>
<thead>
<tr>
<th>参数名</th>
<th>是否必填</th>
<th>类型</th>
<th><div style="width: 400px"/>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>uploadDataMsgid</td>
<td>是</td>
<td>String</td>
<td>平台上传数据流水号,即平台失联修复上传数据接口返回的平台流水号</td>
</tr>
<tr>
<td>callNumber</td>
<td>是</td>
<td>String</td>
<td>主叫号码,必须使用向运营人员报备后的主叫号码</td>
</tr>
<tr>
<td>authCode</td>
<td>是</td>
<td>String</td>
<td>授权码,该上传数据批次的匹配结果接口返回修复成功的授权码,即客户在上传数据接口提交的授权码</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code>{
(认证信息参数)
"param": {
"uploadDataMsgid":"284251611566600000",
"callNumber":"15001090000",
"authCode":"authCode1"
}
}</code></pre>
<h5>产品响应参数(data)</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>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>virtualNumber</td>
<td>否</td>
<td>string</td>
<td>data</td>
<td>中间号,使用提交的主叫号码拨打该号码即可触达失联人,拨打或15分钟后自动解绑,需要再次绑定</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<h6>查询成功</h6>
<pre><code>{
(统一响应参数)
"data": {
"state": "1",
"desc": "成功",
"virtualNumber":"15001091111"
}
}</code></pre>
<h6>查询失败</h6>
<pre><code>{
(统一响应参数)
"data": {
"state": "0",
"desc": "失败"
}
}</code></pre>
<h5>验真状态码及描述</h5>
<table>
<thead>
<tr>
<th>验真状态码(state)</th>
<th>验真状态码描述(desc)</th>
<th>是否收费</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>0</td>
<td>失败</td>
<td>否</td>
</tr>
<tr>
<td>1</td>
<td>成功</td>
<td>否</td>
<td>该情况有其他响应参数,响应的平台流水号可以用来查询话单</td>
</tr>
<tr>
<td>2</td>
<td>30天内触达客户超过限制</td>
<td>否</td>
<td>30天内绑定并拨打的次数已经达到10次</td>
</tr>
<tr>
<td>3</td>
<td>本日内触达次数超过限制</td>
<td>否</td>
<td>本日0点到请求时绑定并拨打的次数已经达到3次</td>
</tr>
</tbody>
</table>