澄曜API Hub

使用说明

1

注册账号

点击页面右上角「注册」按钮，填写邮箱和密码即可注册。注册后即可获得基础调用权限。立即注册

2

获取API Key

登录后进入「用户中心」→「我的Key」页面，点击「生成新Key」按钮获取您的API密钥。前往生成

3

查看接口文档

在首页浏览可用的API接口，点击接口卡片可查看详细文档、参数说明和示例代码。

4

调用接口

使用您的API Key通过HTTP请求调用接口。支持GET和POST两种请求方式，详见下方API调用方式说明。

5

查看调用记录

进入「用户中心」→「调用记录」页面，可查看API调用历史和统计数据。查看记录

API调用方式

支持GET和POST请求，API Key可通过以下三种方式传递（优先级从高到低）：

请求头方式（推荐）：X-API-Key: YOUR_API_KEY
URL参数方式：/api/example?key=YOUR_API_KEY
请求体方式：在POST请求体中包含 "key": "YOUR_API_KEY"

cURL示例

# GET请求（请求头方式）
curl -H "X-API-Key: YOUR_API_KEY" "https://api.ruseo.cn/api/ip_query?ip=8.8.8.8"
# POST请求（JSON格式）
curl -H "X-API-Key: YOUR_API_KEY" \\
     -H "Content-Type: application/json" \\
     -d '{"param1": "value1"}' \\
     "https://api.ruseo.cn/api/example"

JavaScript/Node.js示例

// 使用fetch API
fetch('https://api.ruseo.cn/api/ip_query?ip=8.8.8.8', {
    headers: {
        'X-API-Key': 'YOUR_API_KEY'
    }
})
.then(res => res.json())
.then(data => console.log(data));

Python示例

# 使用requests库
import requests
headers = {'X-API-Key': 'YOUR_API_KEY'}
response = requests.get('https://api.ruseo.cn/api/ip_query',
                    params={'ip': '8.8.8.8'},
                    headers=headers)
print(response.json())

PHP示例

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.ruseo.cn/api/ip_query?ip=8.8.8.8');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Key: YOUR_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
print_r(json_decode($response, true));

Java示例

// 使用HttpClient (Java 11+)
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.ruseo.cn/api/ip_query?ip=8.8.8.8"))
    .header("X-API-Key", "YOUR_API_KEY")
    .GET()
    .build();
HttpResponse response = client.send(request,
    HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

💡 提示

API Key是您身份的唯一标识，请妥善保管，不要泄露给他人。建议定期更换API Key以保证安全。

限流规则

普通用户：180次/分钟
VIP用户：更高配额，详见VIP页面
超出限制：返回 {"code": 429, "msg": "请求过于频繁"}

HTTP状态码说明

状态码	说明	解决方案
200	请求成功	API调用正常
400	请求参数错误	检查请求参数是否完整、格式是否正确
401	未授权/API Key缺失	在请求中添加有效的API Key参数
403	无权限访问	检查API Key是否激活，或是否需要登录/VIP权限
404	接口不存在或未发布	检查接口路由是否正确，确认接口已发布
405	请求方法不允许	使用接口支持的请求方法（GET/POST）
419	CSRF令牌过期	刷新页面后重新操作
422	缺少必需参数	检查并补充必填参数
429	请求过于频繁	降低调用频率或升级VIP
500	服务器内部错误	稍后重试或联系技术支持

业务错误码说明

API响应中code字段的业务错误码：

错误码	说明	解决方案
0	请求成功	业务处理正常
-1	系统错误	联系技术支持
1001	参数验证失败	检查参数格式和必填项
1002	API Key已过期	重新生成API Key
1003	用户账号已冻结	联系客服解冻
1004	VIP权限已过期	续费VIP会员
1005	调用次数已用完	等待次日重置或升级VIP
1006	接口维护中	稍后再试

常见问题

点击页面右上角「注册」按钮，填写邮箱和密码即可注册。注册成功后自动获得API Key使用权限，可立即开始调用API。

点击登录页面的「忘记密码」链接，输入注册邮箱，系统会发送验证码到您的邮箱，输入验证码即可重置密码。

请检查Key是否正确复制，注意不要有多余空格或换行符。如仍无效，可进入「用户中心」→「我的Key」页面重新生成新的Key。如果问题依旧，请联系客服。

请求频率超过限制。普通用户限制180次/分钟，VIP用户享有更高配额。建议降低调用频率、增加请求间隔时间，或升级VIP获取更高配额。

进入「VIP会员」页面选择合适套餐，支持支付宝和微信支付完成开通。开通后立即生效，享有更高调用配额和专属接口权限。

不会失效，API Key仍然可以继续使用，但调用配额会降为普通用户标准（180次/分钟），且无法访问VIP专属接口。建议及时续费以保持VIP权益。

支持所有支持HTTP请求的编程语言，包括但不限于：JavaScript/Node.js、Python、PHP、Java、Go、C#、Ruby等。帮助中心提供了多种语言的调用示例代码。

API Key可以通过三种方式传递：请求头（推荐）、URL参数或请求体。建议使用请求头方式传递，更加安全。绝对不要将API Key暴露在前端代码或公开仓库中。

登录后进入「用户中心」→「调用记录」页面，可以查看最近的API调用历史，包括调用时间、接口名称、请求状态和响应耗时等信息。

可以通过升级VIP会员获得更高的调用配额。VIP会员享有更高的请求频率限制和更多的调用次数。具体配额请查看VIP会员页面。

500错误表示服务器内部错误，请稍后重试。如果问题持续存在，请记录错误发生的时间和请求详情，联系客服协助排查问题。

每个账号可以生成多个API Key，方便在不同项目中使用。进入「用户中心」→「我的Key」页面即可管理多个API Key，支持启用/禁用和删除操作。

所有API接口均返回JSON格式数据，编码为UTF-8。标准响应格式包含code（业务状态码）、msg（提示信息）和data（数据内容）字段。

支持，强烈建议使用HTTPS协议调用API，确保数据传输安全。API端点支持HTTP和HTTPS两种协议，推荐使用HTTPS。

联系我们

邮箱

makabaka@cilacila.cn

工作时间

周一至周五 9:00-18:00