Free API Hub

API 文档

Free API Hub 的完整API文档，包含认证方式、调用示例、响应格式等详细信息。 快速集成免费API到您的应用中。

API地址

https://api.524900.xyz

认证方式

X-API-Key Header

每日配额

100 次/天

认证方式

Free API Hub 使用 API Key 进行身份认证。您需要在每次请求的 HTTP Header 中携带X-API-Key字段，值为您的 API Key。

获取 API Key

  1. 访问 Free API Hub 官网并注册账号
  2. 登录后进入控制台
  3. 在 API Key 管理页面创建新的 Key
  4. 将生成的 Key 复制并安全保存

安全提醒：请勿将 API Key 泄露给他人或在客户端代码中明文存储。 建议将 API Key 存放在后端环境变量中。

调用示例

天气查询

根据城市名称查询实时天气和未来天气预报

curl
curl -X GET "https://api.524900.xyz/weather?city=北京" \
  -H "X-API-Key: YOUR_API_KEY"

二维码生成

将链接或文本内容生成二维码图片

curl
curl -X POST "https://api.524900.xyz/qrcode" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "https://524900.xyz", "size": 300}'

随机笑话

获取一条随机趣味笑话

curl
curl -X GET "https://api.524900.xyz/jokes/random" \
  -H "X-API-Key: YOUR_API_KEY"

响应格式

成功响应

JSON
{
  "success": true,
  "code": 200,
  "data": {
    // 具体业务数据
  },
  "message": "请求成功"
}

错误响应

JSON
{
  "success": false,
  "code": 401,
  "error": "unauthorized",
  "message": "无效的API Key，请检查您的认证信息"
}

常见 HTTP 状态码

状态码含义说明
200OK请求成功
400Bad Request请求参数错误
401UnauthorizedAPI Key 无效或缺失
403Forbidden权限不足或超出配额
404Not Found请求的资源不存在
429Too Many Requests请求过于频繁，请稍后重试
500Internal Server Error服务器内部错误