什么是空號(hào)檢測(cè)接口？
空號(hào)檢測(cè)接口是用于驗(yàn)證手機(jī)號(hào)是否真實(shí)存在的工具。支持判斷號(hào)碼是否為空號(hào)、沉默號(hào)、停機(jī)號(hào)、風(fēng)險(xiǎn)號(hào)等，適用于營(yíng)銷前數(shù)據(jù)清洗、提升撥號(hào)效率等場(chǎng)景。

空號(hào)檢測(cè)支持哪些運(yùn)營(yíng)商？
目前支持中國(guó)大陸三大運(yùn)營(yíng)商：移動(dòng)、聯(lián)通、電信的11位手機(jī)號(hào)。

每次最多能提交多少個(gè)手機(jī)號(hào)？
每次接口調(diào)用最多支持提交10個(gè)手機(jī)號(hào)，超過(guò)限制將返回參數(shù)錯(cuò)誤。

空號(hào)檢測(cè)接口調(diào)用后多久能返回檢測(cè)結(jié)果？
空號(hào)檢測(cè)為實(shí)時(shí)接口，提交后立即返回檢測(cè)結(jié)果和計(jì)費(fèi)狀態(tài)，適合在用戶注冊(cè)、批量營(yíng)銷前快速篩查號(hào)碼有效性。

空號(hào)檢測(cè)檢測(cè)結(jié)果中的 state 字段是什么意思？
state=1 表示有效號(hào)碼；2 表示空號(hào)；3 表示沉默號(hào)（長(zhǎng)期未活躍）；4 表示高風(fēng)險(xiǎn)號(hào)碼（如停機(jī)）；-1 表示檢測(cè)失敗或狀態(tài)未知。

什么是 charge_state 字段？
charge_state 表示當(dāng)前號(hào)碼是否計(jì)費(fèi)：1 為計(jì)費(fèi)，-1 為不計(jì)費(fèi)。通常只有當(dāng)號(hào)碼狀態(tài)為“正常”時(shí)才會(huì)計(jì)費(fèi)，異常狀態(tài)將不計(jì)費(fèi)。

空號(hào)檢測(cè)接口如何進(jìn)行加密與認(rèn)證？
所有請(qǐng)求需使用 HMAC-SHA256 簽名認(rèn)證，并在請(qǐng)求頭中傳遞 Authorization 簽名字段。簽名方式請(qǐng)參閱：簽名機(jī)制說(shuō)明。

查詢賬戶剩余檢測(cè)條數(shù)的接口怎么使用？
調(diào)用余額查詢接口 `https://api.ihuyi.com/empty-number/balance`，提交帶有簽名的 GET 請(qǐng)求即可獲取賬戶剩余可用檢測(cè)次數(shù)。

調(diào)用空號(hào)檢測(cè)接口失敗時(shí)如何排查問(wèn)題？

請(qǐng)查看返回的 code 和 msg 字段信息，例如 4051 表示剩余條數(shù)不足，400 表示非法 IP，1100 表示參數(shù)格式錯(cuò)誤。建議結(jié)合接口文檔檢查請(qǐng)求結(jié)構(gòu)與簽名。

空號(hào)檢測(cè)是否提供開(kāi)發(fā)示例和接入指南？
互億無(wú)線提供完整的空號(hào)檢測(cè) API 接口文檔、簽名機(jī)制說(shuō)明、以及多語(yǔ)言 DEMO 示例（Java、PHP、Python、Go 等），方便快速接入。查看簽名機(jī)制文檔