前言:
在使用过程中遇到问题请先在帮助文档内查找相关内容帮助,如果没有解决方案 可以联系我们协助解决!PHP通用示例代码:
<?php
/**
* PHP请求示例
* http://xxxxx.com/test.php?url=baidu.com
* 带Key接口地址
* http://s.api.2ita.com/api/Icp?参数&apikey=接口key
**/
error_reporting(0); //关闭错误
$url = $_GET["url"]; //获取GET参数
if ($url) {
$content = file_get_contents("http://s.api.2ita.com/api/Icp?url=".$url); //接口地址
$arr = json_decode($content, true);
if ($arr["code"] =="200") { //判断响应码
echo "响应码: ".$arr["code"]."<br>";
echo "备案名称: ".$arr["data"]["organizer_name"]."<br>";
echo "备案性质: ".$arr["data"]["nature"];
} else {
echo $arr["code"];
}
}else {
echo "参数错误";
}
/**
*更多例子 期待您的加入
**/
?>
POST Header/请求头:
POST请求时Header/请求头为 Content-Type: application/x-www-form-urlencoded;charset=UTF-8 application/x-www-form-urlencoded属于比较常用的POST 提交数据的方式,按照 k1=v1&k2=v2 的方式进行编码,然后进行提交,而不是json格式提交!接口状态:
接口颜色 | 状态说明 | 建议 |
---|---|---|
红色 | 正常 | 接口一切正常 |
灰色 | 维护中 | 接口正在维护中.. 请耐心等待 |
黄色 | 调试中 | 接口正在调试中.. 准备上架 |
删除接口KEY:
不在需要使用接口了可以选择删除KEY!详情 控制台 > 接口管理 > 我的接口 > 设置 > KEY ID删除! 注意:此操作不可逆,请谨慎操作并发\请求限制:
用户组 | 请求方式 | 并发(10秒) | 线路 |
---|---|---|---|
游客\无Key用户 | HTTP(S) , GET/POST | 3次 | 国内CDN 50+节点 |
注册用户\有Key用户 | HTTP(S) , GET/POST | 50次 | 国内CDN 50+节点 |
请求规则设置:
规则类型主要分为: IP、Referer、请求参数、来源域名 处置方式分为: 放行、禁止、阻断 ,优先级也按照这个顺序 放行可以理解为白名单模式。禁止可以理解为黑名单模式。阻断是直接是不响应,不返回任何提示! 都属于逻辑性运算 规则类型优先级的顺序也是按照 IP、Referer、请求参数、来源域名 排列处理! 举例1: 放行IP 1.1.1.1 那么这个接口就只能是IP等于1.1.1.1的能请求,其他的请求一律拒绝并返回提示! 举例2: 同时放行IP 1.1.1.1 和 Referer https://www.baidu.com/xx.html 那么请求这个接口需要先满足IP的条件在满足Referer的条件才能请求,缺一不可 。如果是同时禁止则满足一个条件就认为被禁止 举例3: 放行IP 2.2.2.2 又禁止IP 2.2.2.2 ,那么禁止规则将无效! IP 2.2.2.2依然可以请求接口 其他规则也同理!请求日志:
请求日志可以对拥有的接口调用情况一目了然!详情 控制台 > 接口管理 > 请求日志。请求日志暂为保存30天接口开关:
保证用户资源不被滥用,避免造成不良影响,我们还设置了接口Key开关,不用的时候可以关闭!详情 控制台 > 接口管理 > 我的接口 > 设置,进行禁用系统响应码说明:
名称 | 类型 | 响应码 | 说明 | 解决方案 |
---|---|---|---|---|
code | String | 1401 | 需要KEY | 注册登录 免费开通需要的接口即可获取相应的KEY |
code | String | 1403 | 该KEY被开发者禁用 | 开发者在控制台禁用了KEY |
code | String | 1404 | 接口不存在 | 请求了错误的接口地址,请在接口文档页面重新获取接口地址 |
code | String | 1412 | 非法操作 | 操作行为被系统检测出违规 被禁止操作 |
code | String | 1500 | 未知错误 | 未知错误 一般不会出现,如果你遇到了 请联系管理员协助处理 |
code | String | 1502 | 请求频率限制 | 这个一般出现在游客无KEY的请求模式上,注册登录免费开通获取KEY即可解决 |
code | String | 1503 | 接口维护中 | 接口处于维护状态,请耐心等待 |
code | String | 2401 | KEY过期 | 请登录控制台续费 |
code | String | 2403 | 该KEY被管理员禁用 | 违规调用,被封禁KEY,第一次可以联系管理员解封 |
code | String | 2404 | 接口已下架 | 接口被管理员下架,没办法了 无法解决! |
code | String | 3401 | 没有可用次数 | 按次开通的,调用次数已经用完 登录控制台续费 即可恢复 |
code | String | 3403 | 账户被禁用 | 这种情况一般不会出现,如果你遇到了 那么恭喜你! |
code | String | 3404 | 请求域错误 | 请求的接口域名错误,查看对应得API文档获取正确的接口域名 |
code | String | 4401 | 无效KEY | 登录控制台获取对应正确的KEY |
code | String | 4403 | 非法请求 | 不支持GET、POST、AJAX 以外的请求 |
code | String | 4404 | 引导缺失 | 接口未完善,等待完善 |
code | String | 5401 | 接口调试中 | 接口处于调试状态,即将上架,请耐心等待!一般不会超过一个小时 |
code | String | 5403 | 开发者启用请求规则限制 | 查看控制台请求规则设置是否正确 |
code | String | 6403 | 请求被拒绝 | 管理员设置的全局请求规则,此次请求不在允许范围(IP、Referer、请求参数、来源域名) |
code | String | 9403 | 调用服务已关闭 | 这个是系统关闭了调用功能,具体原因请咨询管理员 |
code | String | 9503 | 系统处于维护状态 | 系统维护升级,一般看首页公告 得知恢复时间 |