API 文档：随机图片资源获取接口

API 文档：随机资源获取接口

基础信息

• 接口版本：2.4.0
• 文档链接：查看完整文档
• 最后更新时间：2025-03-30

接口功能
根据指定类型返回随机资源URL，支持多种资源类型选择。

请求方式
GET

请求地址
https://api.hueoo.com/v1/img/get

请求参数

成功响应示例

{
    "code": 200,
    "msg": "请求成功",
    "data": {
        "url": "https://example.com/resource1",
        "type": "acg",
        "total": 50
    },
    "ts": 1732809600000,
    "cost": "15.23ms",
    "ip": "123.45.67.89",
    "info": {
        "update": "2025-03-30 15:30:00",
        "doc": "https://api.example.com/docs",
        "ver": "2.4.0"
    }
}

错误响应示例

{
    "code": 400,
    "msg": "[INVALID_TYPE] 参数错误：请求参数不符合要求",
    "data": [],
    "ts": 1732809600000,
    "cost": "3.12ms",
    "ip": "123.45.67.89",
    "info": {
        "update": "2025-03-30 15:30:00",
        "doc": "https://api.example.com/docs",
        "ver": "2.4.0"
    }
}

常见错误说明

• 400 INVALID_TYPE：请求的资源类型无效
• 403 FILE_UNREADABLE：资源文件不可读
• 404 FILE_MISSING：请求的资源不存在
• 422 URL_INVALID：资源包含无效URL
• 500 FILE_READ_FAIL：服务器读取资源失败
• 503 MEM_OVERFLOW：服务器内存不足

使用说明

1. 必须携带type参数指定资源类型
2. 返回结果中的total字段表示该类型可用资源总数
3. url字段为随机选取的有效资源地址
4. 响应包含详细的请求处理耗时和客户端信息

支持资源类型

• wzry：王者荣耀全英雄皮肤壁纸
• aaa：其他分类资源
• news：新闻资讯资源
• video：视频资源

注意事项

• 所有请求均需通过GET方式发送
• 错误响应会包含详细错误说明
• 接口响应包含版本信息便于调试