号码标记监测-标记查询
<p>[TOC]</p>
<h5>产品描述</h5>
<ul>
<li>标记查询接口用来查询导入号码的标记信息。号码标记监测产品有两个接口，首先要调用号码添加接口，导入需要标记监测的号码，然后再调用标记查询接口，以便查询导入号码的标记信息。建议在调用号码添加接口后，间隔两小时再调用标记查询接口，系统是每小时跑一次标记查询，如果数据对接量级大，还需要排队等待。</li>
</ul>
<h5>接口地址</h5>
<ul>
<li>请求地址：<code>https://api.caih.com/verify/api/sign_search</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">https://www.showdoc.cc/p/52021eddfd9994a7b84d891a16e27f66</a> "认证信息参数和统一响应参数")</li>
<li>如需加密对接请查看页面 [加密对接说明](<a href="https://www.showdoc.cc/p/dfff667dec3c68748dddde67674eb993">https://www.showdoc.cc/p/dfff667dec3c68748dddde67674eb993</a> "加密对接说明")，并联系运营人员进行配置</li>
</ul>
<h5>校验请求参数（param）</h5>
<p>服务编码请查看本页章节 <code>验真状态码及描述</code> 。</p>
<table>
<thead>
<tr>
<th>参数名</th>
<th>是否必填</th>
<th>类型</th>
<th><div style="width: 400px"/>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>tels</td>
<td>否</td>
<td>string</td>
<td>号码列表，英文逗号隔开（最多支持10000个号码），支持固话、手机号、95和400等特殊号码，详见号码格式说明</td>
</tr>
<tr>
<td>batchUniqueId</td>
<td>否</td>
<td>string</td>
<td>号码添加接口返回的批次，32位,例如：u910043b9cbb24338291d27f3306c06c</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code>{
(认证信息参数)
&quot;param&quot;: {
&quot;batchUniqueId&quot;: &quot;u910043b9cbb24338291d27f3306c06c&quot;
}
}</code></pre>
<h5>产品响应参数（data）</h5>
<p>验真状态码及描述请查看本页章节 <code>验真状态码及描述</code> 。</p>
<table>
<thead>
<tr>
<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>验真状态码</td>
</tr>
<tr>
<td>desc</td>
<td>是</td>
<td>string</td>
<td>验真状态码描述</td>
</tr>
<tr>
<td>items</td>
<td>否</td>
<td>json</td>
<td>号码标记列表</td>
</tr>
<tr>
<td>batchUniqueId</td>
<td>否</td>
<td>items</td>
<td>批次</td>
</tr>
<tr>
<td>batchStatus</td>
<td>否</td>
<td>items</td>
<td>批次状态</td>
</tr>
<tr>
<td>phone</td>
<td>否</td>
<td>items</td>
<td>号码</td>
</tr>
<tr>
<td>status</td>
<td>否</td>
<td>items</td>
<td>号码状态</td>
</tr>
<tr>
<td>mobileHousekeeperName</td>
<td>否</td>
<td>items</td>
<td>手机管家内容（目前不支持返回值）</td>
</tr>
<tr>
<td>mobileHousekeeperTimes</td>
<td>否</td>
<td>items</td>
<td>手机管家次数（目前不支持返回值）</td>
</tr>
<tr>
<td>mobileHousekeeperShowName</td>
<td>否</td>
<td>items</td>
<td>手机管家展示名称（目前不支持返回值）</td>
</tr>
<tr>
<td>securityGuardName</td>
<td>否</td>
<td>items</td>
<td>360安全卫士标记内容</td>
</tr>
<tr>
<td>securityGuardTimes</td>
<td>否</td>
<td>items</td>
<td>360安全卫士标记次数</td>
</tr>
<tr>
<td>securityGuardShowName</td>
<td>否</td>
<td>items</td>
<td>360安全卫士展示名称</td>
</tr>
<tr>
<td>telephoneBondName</td>
<td>否</td>
<td>items</td>
<td>电话邦标记内容</td>
</tr>
<tr>
<td>telephoneBondTimes</td>
<td>否</td>
<td>items</td>
<td>电话邦标记次数</td>
</tr>
<tr>
<td>telephoneBondShowName</td>
<td>否</td>
<td>items</td>
<td>电话邦展示名称</td>
</tr>
<tr>
<td>mobileGuardName</td>
<td>否</td>
<td>items</td>
<td>百度手机卫士标记内容</td>
</tr>
<tr>
<td>mobileGuardTimes</td>
<td>否</td>
<td>items</td>
<td>百度手机卫士标记次数</td>
</tr>
<tr>
<td>mobileGuardShowName</td>
<td>否</td>
<td>items</td>
<td>百度手机卫士展示名称</td>
</tr>
<tr>
<td>numberLinkName</td>
<td>否</td>
<td>items</td>
<td>搜狗号码通标记内容</td>
</tr>
<tr>
<td>numberLinkTimes</td>
<td>否</td>
<td>items</td>
<td>搜狗号码通标记次数</td>
</tr>
<tr>
<td>numberLinkShowName</td>
<td>否</td>
<td>items</td>
<td>搜狗号码通展示名称</td>
</tr>
<tr>
<td>otherName</td>
<td>否</td>
<td>items</td>
<td>泰迪熊标记类型</td>
</tr>
<tr>
<td>otherTimes</td>
<td>否</td>
<td>items</td>
<td>泰迪熊标记次数</td>
</tr>
<tr>
<td>otherShowName</td>
<td>否</td>
<td>items</td>
<td>泰迪熊展示名称</td>
</tr>
<tr>
<td>date</td>
<td>否</td>
<td>items</td>
<td>日期（标记出来结果的日期）</td>
</tr>
<tr>
<td>createTime</td>
<td>否</td>
<td>items</td>
<td>号码导入时间</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<h6>查询成功</h6>
<pre><code>{
(统一响应参数)
&quot;data&quot;: {
&quot;state&quot;: &quot;1&quot;,
&quot;desc&quot;: &quot;成功&quot;,
&quot;items&quot;: [
{
&quot;batchUniqueId&quot;: &quot;u910043b9cbb24338291d27f3306c06c&quot;,
&quot;batchStatus&quot;: &quot;查询中&quot;,
&quot;phone&quot;: &quot;15001090000&quot;,
&quot;status&quot;: &quot;查询中&quot;,
&quot;mobileHousekeeperName&quot;: &quot;--&quot;,
&quot;mobileHousekeeperTimes&quot;: &quot;--&quot;,
&quot;mobileHousekeeperShowName&quot;: &quot;--&quot;,
&quot;securityGuardName&quot;: &quot;--&quot;,
&quot;securityGuardTimes&quot;: &quot;--&quot;,
&quot;securityGuardShowName&quot;: &quot;--&quot;,
&quot;telephoneBondName&quot;: &quot;--&quot;,
&quot;telephoneBondTimes&quot;: &quot;--&quot;,
&quot;telephoneBondShowName&quot;: &quot;--&quot;,
&quot;mobileGuardName&quot;: &quot;--&quot;,
&quot;mobileGuardTimes&quot;: &quot;--&quot;,
&quot;mobileGuardShowName&quot;: &quot;--&quot;,
&quot;numberLinkName&quot;: &quot;--&quot;,
&quot;numberLinkTimes&quot;: &quot;--&quot;,
&quot;numberLinkShowName&quot;: &quot;--&quot;,
&quot;otherName&quot;: &quot;--&quot;,
&quot;otherTimes&quot;: &quot;--&quot;,
&quot;otherShowName&quot;: &quot;--&quot;,
&quot;date&quot;: &quot;2022-07-07&quot;,
&quot;createTime&quot;: &quot;2022-07-07 11:00:59&quot;
},
{
&quot;batchUniqueId&quot;: &quot;u910043b9cbb24338291d27f3306c06c&quot;,
&quot;batchStatus&quot;: &quot;查询中&quot;,
&quot;phone&quot;: &quot;15001090001&quot;,
&quot;status&quot;: &quot;查询中&quot;,
&quot;mobileHousekeeperName&quot;: &quot;--&quot;,
&quot;mobileHousekeeperTimes&quot;: &quot;--&quot;,
&quot;mobileHousekeeperShowName&quot;: &quot;--&quot;,
&quot;securityGuardName&quot;: &quot;--&quot;,
&quot;securityGuardTimes&quot;: &quot;--&quot;,
&quot;securityGuardShowName&quot;: &quot;--&quot;,
&quot;telephoneBondName&quot;: &quot;--&quot;,
&quot;telephoneBondTimes&quot;: &quot;--&quot;,
&quot;telephoneBondShowName&quot;: &quot;--&quot;,
&quot;mobileGuardName&quot;: &quot;--&quot;,
&quot;mobileGuardTimes&quot;: &quot;--&quot;,
&quot;mobileGuardShowName&quot;: &quot;--&quot;,
&quot;numberLinkName&quot;: &quot;--&quot;,
&quot;numberLinkTimes&quot;: &quot;--&quot;,
&quot;numberLinkShowName&quot;: &quot;--&quot;,
&quot;otherName&quot;: &quot;--&quot;,
&quot;otherTimes&quot;: &quot;--&quot;,
&quot;otherShowName&quot;: &quot;--&quot;,
&quot;date&quot;: &quot;2022-07-07&quot;,
&quot;createTime&quot;: &quot;2022-07-07 11:00:59&quot;
}
]
}
}</code></pre>
<h6>查询失败</h6>
<pre><code>{
(统一响应参数)
&quot;data&quot;: {
&quot;state&quot;: &quot;0&quot;,
&quot;desc&quot;: &quot;失败&quot;
}
}</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>
</tr>
</tbody>
</table>
<h5>号码格式说明</h5>
<table>
<thead>
<tr>
<th>号码类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>固话</td>
<td>区号+7~8 位号码</td>
</tr>
<tr>
<td>手机号</td>
<td>11 位手机号码</td>
</tr>
<tr>
<td>96 号码</td>
<td>加区号，尾数不少于3位，不算区号不超过15位</td>
</tr>
<tr>
<td>95 号码</td>
<td>不加区号，尾数不少于3位，最长不超过17位</td>
</tr>
<tr>
<td>400 号码</td>
<td>不加区号，号码固定长度为10位</td>
</tr>
<tr>
<td>1010 号码</td>
<td>不加区号，号码长度不少于 8 位，最长不超15位</td>
</tr>
<tr>
<td>116、118</td>
<td>号码长度不少于 4 位，最长不超过23位</td>
</tr>
<tr>
<td>1019 号码</td>
<td>不加区号，1019 开头的号码</td>
</tr>
</tbody>
</table>