Files
leonapp/apidocs/openapi.json

1091 lines
34 KiB
JSON
Raw Normal View History

{
"openapi": "3.0.0",
"info": {
"title": "App Store API",
"description": "App Store API v2.0 - 提供应用商店的各种数据接口",
"version": "2.0.0"
},
"servers": [
{
"url": "http://localhost/APP Store",
"description": "本地开发服务器"
}
],
"paths": {
"/api.php": {
"get": {
"summary": "API端点总览",
"description": "显示所有可用的API端点信息",
"parameters": [
{
"name": "t",
"in": "query",
"description": "API类型参数留空则显示所有端点",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "成功获取端点信息",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "success"
},
"message": {
"type": "string",
"example": "App Store API v2.0"
},
"endpoints": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"example": {
"type": "string",
"example": "/api.php?t=getallapps"
}
}
}
}
}
}
}
}
},
"/api.php?t=getallapps": {
"get": {
"summary": "获取所有应用列表",
"description": "获取所有已批准的应用列表,支持分页",
"parameters": [
{
"name": "page",
"in": "query",
"description": "页码",
"required": false,
"schema": {
"type": "integer",
"default": 1
}
},
{
"name": "limit",
"in": "query",
"description": "每页数量",
"required": false,
"schema": {
"type": "integer",
"default": 20,
"maximum": 100
}
}
],
"responses": {
"200": {
"description": "成功获取应用列表",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "success"
},
"data": {
"type": "object",
"properties": {
"apps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"age_rating": {
"type": "string"
},
"version": {
"type": "string"
},
"avg_rating": {
"type": "number"
},
"total_downloads": {
"type": "integer"
}
}
}
},
"pagination": {
"type": "object",
"properties": {
"total": {
"type": "integer"
},
"page": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"totalPages": {
"type": "integer"
}
}
}
}
}
}
}
}
}
}
}
}
},
"/api.php?t=getappinfo": {
"get": {
"summary": "获取应用详细信息",
"description": "获取指定应用的详细信息,包括版本、图片和标签",
"parameters": [
{
"name": "id",
"in": "query",
"description": "应用ID",
"required": true,
"schema": {
"type": "integer"
}
}
],
"responses": {
"200": {
"description": "成功获取应用信息",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "success"
},
"data": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"age_rating": {
"type": "string"
},
"version": {
"type": "string"
},
"avg_rating": {
"type": "number"
},
"total_downloads": {
"type": "integer"
},
"platforms": {
"type": "array"
},
"versions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"version": {
"type": "string"
},
"changelog": {
"type": "string"
},
"file_path": {
"type": "string"
},
"download_count": {
"type": "integer"
},
"created_at": {
"type": "string"
}
}
}
},
"images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"image_path": {
"type": "string"
}
}
}
},
"tags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
}
}
}
}
}
}
}
}
}
}
},
"400": {
"description": "无效的应用ID",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "error"
},
"message": {
"type": "string",
"example": "请提供有效的应用ID"
}
}
}
}
}
},
"404": {
"description": "未找到应用",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "error"
},
"message": {
"type": "string",
"example": "未找到该应用"
}
}
}
}
}
}
}
}
},
"/api.php?t=getalltags": {
"get": {
"summary": "获取所有标签",
"description": "获取所有可用的应用标签",
"responses": {
"200": {
"description": "成功获取标签列表",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "success"
},
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
}
}
}
}
}
}
}
}
}
}
}
},
"/api.php?t=gettagapp": {
"get": {
"summary": "获取标签下的应用",
"description": "获取指定标签下的所有应用列表,支持分页",
"parameters": [
{
"name": "id",
"in": "query",
"description": "标签ID",
"required": true,
"schema": {
"type": "integer"
}
},
{
"name": "page",
"in": "query",
"description": "页码",
"required": false,
"schema": {
"type": "integer",
"default": 1
}
},
{
"name": "limit",
"in": "query",
"description": "每页数量",
"required": false,
"schema": {
"type": "integer",
"default": 20,
"maximum": 100
}
}
],
"responses": {
"200": {
"description": "成功获取标签下的应用列表",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "success"
},
"data": {
"type": "object",
"properties": {
"tag": {
"type": "object",
"properties": {
"name": {
"type": "string"
}
}
},
"apps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"age_rating": {
"type": "string"
},
"version": {
"type": "string"
},
"avg_rating": {
"type": "number"
}
}
}
},
"pagination": {
"type": "object",
"properties": {
"total": {
"type": "integer"
},
"page": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"totalPages": {
"type": "integer"
}
}
}
}
}
}
}
}
}
},
"400": {
"description": "无效的标签ID",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "error"
},
"message": {
"type": "string",
"example": "请提供有效的标签ID"
}
}
}
}
}
},
"404": {
"description": "未找到标签",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "error"
},
"message": {
"type": "string",
"example": "未找到该标签"
}
}
}
}
}
}
}
}
},
"/api.php?t=getdeveloperapp": {
"get": {
"summary": "获取开发者的应用",
"description": "获取指定开发者的所有应用列表,支持分页",
"parameters": [
{
"name": "id",
"in": "query",
"description": "开发者ID",
"required": true,
"schema": {
"type": "integer"
}
},
{
"name": "page",
"in": "query",
"description": "页码",
"required": false,
"schema": {
"type": "integer",
"default": 1
}
},
{
"name": "limit",
"in": "query",
"description": "每页数量",
"required": false,
"schema": {
"type": "integer",
"default": 20,
"maximum": 100
}
}
],
"responses": {
"200": {
"description": "成功获取开发者的应用列表",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "success"
},
"data": {
"type": "object",
"properties": {
"developer": {
"type": "object",
"properties": {
"username": {
"type": "string"
}
}
},
"apps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"age_rating": {
"type": "string"
},
"version": {
"type": "string"
},
"created_at": {
"type": "string"
}
}
}
},
"pagination": {
"type": "object",
"properties": {
"total": {
"type": "integer"
},
"page": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"totalPages": {
"type": "integer"
}
}
}
}
}
}
}
}
}
},
"400": {
"description": "无效的开发者ID",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "error"
},
"message": {
"type": "string",
"example": "请提供有效的开发者ID"
}
}
}
}
}
},
"404": {
"description": "未找到开发者",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "error"
},
"message": {
"type": "string",
"example": "未找到该开发者"
}
}
}
}
}
}
}
}
},
"/api.php?t=getdeveloperinfo": {
"get": {
"summary": "获取开发者信息",
"description": "获取指定开发者的详细信息,包括应用数量和下载量",
"parameters": [
{
"name": "id",
"in": "query",
"description": "开发者ID",
"required": true,
"schema": {
"type": "integer"
}
}
],
"responses": {
"200": {
"description": "成功获取开发者信息",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "success"
},
"data": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"username": {
"type": "string"
},
"email": {
"type": "string"
},
"created_at": {
"type": "string"
},
"app_count": {
"type": "integer"
},
"total_downloads": {
"type": "integer"
}
}
}
}
}
}
}
},
"400": {
"description": "无效的开发者ID",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "error"
},
"message": {
"type": "string",
"example": "请提供有效的开发者ID"
}
}
}
}
}
},
"404": {
"description": "未找到开发者",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "error"
},
"message": {
"type": "string",
"example": "未找到该开发者"
}
}
}
}
}
}
}
}
},
"/api.php?t=getalldevelopers": {
"get": {
"summary": "获取所有开发者列表",
"description": "获取所有开发者的列表,支持分页",
"parameters": [
{
"name": "page",
"in": "query",
"description": "页码",
"required": false,
"schema": {
"type": "integer",
"default": 1
}
},
{
"name": "limit",
"in": "query",
"description": "每页数量",
"required": false,
"schema": {
"type": "integer",
"default": 20,
"maximum": 100
}
}
],
"responses": {
"200": {
"description": "成功获取开发者列表",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "success"
},
"data": {
"type": "object",
"properties": {
"developers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"username": {
"type": "string"
},
"email": {
"type": "string"
},
"created_at": {
"type": "string"
},
"app_count": {
"type": "integer"
},
"total_downloads": {
"type": "integer"
}
}
}
},
"pagination": {
"type": "object",
"properties": {
"total": {
"type": "integer"
},
"page": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"totalPages": {
"type": "integer"
}
}
}
}
}
}
}
}
}
}
}
}
},
"/api.php?t=getacc": {
"get": {
"summary": "获取所有公告",
"description": "获取所有系统公告",
"responses": {
"200": {
"description": "成功获取公告列表",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "success"
},
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"title": {
"type": "string"
},
"content": {
"type": "string"
},
"created_at": {
"type": "string"
}
}
}
}
}
}
}
}
}
}
}
},
"/api.php?t=getcount": {
"get": {
"summary": "获取计数信息",
"description": "获取应用商店的各类统计信息",
"responses": {
"200": {
"description": "成功获取计数信息",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "success"
},
"data": {
"type": "object",
"properties": {
"total_apps": {
"type": "integer"
},
"total_developers": {
"type": "integer"
},
"total_tags": {
"type": "integer"
},
"total_announcements": {
"type": "integer"
},
"total_downloads": {
"type": "integer"
}
}
}
}
}
}
}
}
}
}
},
"/api.php?t=getappversions": {
"get": {
"summary": "获取应用版本列表",
"description": "获取指定应用的所有版本列表,支持分页",
"parameters": [
{
"name": "id",
"in": "query",
"description": "应用ID",
"required": true,
"schema": {
"type": "integer"
}
},
{
"name": "page",
"in": "query",
"description": "页码",
"required": false,
"schema": {
"type": "integer",
"default": 1
}
},
{
"name": "limit",
"in": "query",
"description": "每页数量",
"required": false,
"schema": {
"type": "integer",
"default": 20,
"maximum": 100
}
}
],
"responses": {
"200": {
"description": "成功获取版本列表",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "success"
},
"data": {
"type": "object",
"properties": {
"app_id": {
"type": "integer"
},
"versions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"version": {
"type": "string"
},
"changelog": {
"type": "string"
},
"file_path": {
"type": "string"
},
"download_count": {
"type": "integer"
},
"created_at": {
"type": "string"
}
}
}
},
"pagination": {
"type": "object",
"properties": {
"total": {
"type": "integer"
},
"page": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"totalPages": {
"type": "integer"
}
}
}
}
}
}
}
}
}
},
"400": {
"description": "无效的应用ID",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "error"
},
"message": {
"type": "string",
"example": "请提供有效的应用ID"
}
}
}
}
}
},
"404": {
"description": "未找到应用",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "error"
},
"message": {
"type": "string",
"example": "未找到该应用"
}
}
}
}
}
}
}
}
}
}
}