← 返回首页

API 使用文档

免费、开源的公益API服务

天气查询 API

GET /zz/weather?format=json|img

参数说明

  • format: 返回格式,可选值为 json 或 img(默认为 img)

示例

返回图片(默认):

GET /zz/weather

返回JSON:

GET /zz/weather?format=json

词典查询 API

GET /zz/dict/{word}?format=json|img

数据来源: 使用 Free Dictionary API 提供真实的英文词典数据

参数说明

  • word: 要查询的英文单词(路径参数)
  • format: 返回格式,可选值为 json 或 img(默认为 img)

示例

查询单词(返回图片):

GET /zz/dict/hello

查询单词(返回JSON):

GET /zz/dict/hello?format=json

通用说明

  • 所有API支持跨域访问
  • 图片格式统一为PNG,默认宽度700px,高度自适应
  • API响应包含适当的缓存头信息
  • 错误响应统一为JSON格式
  • 服务完全免费,无需API密钥

错误处理

当API调用出现错误时,会返回相应的HTTP状态码和错误信息:

{
  "success": false,
  "message": "错误描述"
}