API 文档 v1

基本信息

API 基础地址：https://nlitu.com/api/v1

所有 API 返回数据格式均为 JSON，支持跨域请求（CORS）。

随机图片 API

接口说明

获取一张或多张随机图片。

请求参数

参数名	类型	必选	说明
category	string	否	图片分类，如：风景、人像等
limit	integer	否	返回图片数量，默认1，最大100

返回字段

字段名	类型	说明
success	boolean	请求是否成功
data	object/array	图片数据，单张时为对象，多张时为数组
data.id	integer	图片ID
data.title	string	图片标题
data.description	string	图片描述
data.image_url	string	图片URL
data.author	object	作者信息
data.category	string	图片分类
data.stats	object	统计信息（点赞数、收藏数）

示例请求

示例响应

{
    "success": true,
    "data": {
        "id": 1,
        "title": "夕阳下的城市",
        "description": "城市天际线的黄昏时分",
        "image_url": "/uploads/images/sunset.jpg",
        "author": {
            "username": "photographer",
            "nickname": "摄影师小王",
            "avatar": "/uploads/avatars/default.jpg"
        },
        "category": "风景",
        "stats": {
            "loves": 42,
            "stars": 18
        }
    }
}

使用限制

• API 调用频率限制：每IP每分钟不超过60次请求
• 图片仅供个人学习和非商业用途使用
• 使用本API时请注明来源