前言:

在使用过程中遇到问题请先在帮助文档内查找相关内容帮助,如果没有解决方案 可以联系我们协助解决!

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依然可以请求接口

其他规则也同理!


小提示:

IP最后一位可以用通配符,即1.1.1.*

Referer属于绝对性,即https://www.xxx.com/xx.html

参数、来源 属于匹配包含某个值触发规则

请求日志:

请求日志可以对拥有的接口调用情况一目了然!详情 控制台 > 接口管理 > 请求日志。请求日志暂为保存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 系统处于维护状态 系统维护升级,一般看首页公告 得知恢复时间