* API接口可能會因為各種網絡原因和攻擊都可能産生阻斷，請開發時做好冗餘和異常處理
* 當HTTP請求返回的狀態碼非200時，請做異常處理，比如 202 狀態碼造成的原因可能是無效Token、餘額不足、格式錯誤
* 所有接口同時兼容IPv4和IPv6
iP查詢接口文檔說明
接口地址
http協議：
http://api.youripapi.com/ipdata/
https協議：
https://api.youripapi.com/ipdata/
請求方式
get
示例1（Linux命令行下執行）
參數說明:
1. ip string ip地址 例如 117.25.13.123（可選，默認為請求者iP）
2. datatype string txt|jsonp|xml（可選，默認為jsonp）
3. callback string 回調函數 當前參數僅為jsonp格式數據提供（可選，默認為空）
4. token string 購買服務後會提供（必填）
curl "https://api.youripapi.com/ipdata/?ip=8.8.8.8&datatype=jsonp&callback=find" -H "token:cc87f3c77747bccbaaee35006da1ebb65e0bad57"
示例2（js引入推薦方案）
參數說明:
1. ip string ip地址 例如 117.25.13.123（可選，默認為請求者iP）
2. datatype string txt|jsonp|xml（可選，默認為jsonp）
3. callback string 回調函數 當前參數僅為jsonp格式數據提供（可選，默認為空）
4. sign string 簽名驗證 簽名算法:md5("ip=" + ip + "&token=" + token)（必填）
5. oid string 購買服務後提供（必填）
6. mid string 購買服務後提供（必填）
https://api.youripapi.com/ipdata/?ip=8.8.8.8&callback=find&oid={oid}&mid={mid}&sign=簽名算法
示例3（為了您的token安全，請勿在前端代碼中使用token，js引入請參考示例2）
參數說明:
1. ip string ip地址 例如 117.25.13.123（可選，默認為請求者iP）
2. datatype string txt|jsonp|xml（可選，默認為jsonp）
3. callback string 回調函數 當前參數僅為jsonp格式數據提供（可選，默認為空）
4. token string 購買服務後會提供（必填）
JSONP請求示例（IPv4）
https://api.youripapi.com/ipdata/?ip=58.16.180.3&datatype=jsonp&token=cc87f3c77747bccbaaee35006da1ebb65e0bad57
JSONP返回示例（IPv4）
說明：ret 值為 ok 時 返回data查詢結果數據 為err時返回msg錯誤信息
{
"ret": "ok", // ret 值為 ok 時 返回 data 數據 為err時返回msg數據
"ip": "58.16.180.3", // IPv4
"data": [
"中國", // 國家（極少為空）
"貴州", // 省份/自治區/直轄市（少數為空）
"安順", // 地級市（部份為空）
"西秀", // 區/縣（部份為空）
"聯通", // 運營商
"561000", // 郵政編碼
"0851", // 地區區號
"城域網" // 網絡類型（部份為空）
]
}
JSONP請求示例（IPv6）
http://api.youripapi.com/ipdata/?ip=240e:398:1:90a0:585e:a0f6:97d3:bd5&datatype=jsonp&token=cc87f3c77747bccbaaee35006da1ebb65e0bad57
JSONP返回示例（IPv6）
說明：ret 值為 ok 時 返回data查詢結果數據 為err時返回msg錯誤信息
{
"ret": "ok", // ret 值為 ok 時 返回 data 數據 為err時返回msg數據
"ip": "240e:398:1:90a0:585e:a0f6:97d3:bd5", // IPv6
"data": [
"中國", // 國家（極少為空）
"四川", // 省份/自治區/直轄市（少數為空）
"成都", // 地級市（部份為空）
"錦江", // 區/縣（部份為空）
"電信", // 運營商
"610000", // 郵政編碼
"028", // 地區區號
"城域網" // 網絡類型（部份為空）
]
}
XML返回示例
說明：ret 值為 ok 時 返回data查詢結果數據 為err時返回msg錯誤信息
<xmlinfo> <ret>ok</ret> <ip>58.16.180.3</ip> <data> <country>中國</country> <region>貴州</region> <city>安順</city> <district>西秀</district> <isp>聯通</isp> <zip>561000</zip> <zone>0851</zone> <tag>城域網</tag> </data> </xmlinfo>
文本格式返回示例
58.16.180.3 中國 貴州 安順 西秀 聯通 561000 0851
查詢token使用情況
URL
https://api.youripapi.com/status/
請求方式
get
參數
1. token `string` ip查詢服務token
示例
https://api.youripapi.com/status/?token=cc87f3c77747bccbaaee35006da1ebb65e0bad57
響應
{
"ret":"ok",
"data":{
"reqs":10, //當前小時請求數
"hour":3000, //當前小時購買次數
"package":19767 //配額次數
}
}