Files
InfoGenie/api-docs/infogenie-api.json
2026-05-16 19:03:09 +08:00

660 lines
22 KiB
JSON
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"info": {
"_postman_id": "9e4d5b21-ac5f-5d32-b8e2-infogenie01",
"name": "infogenie-api",
"description": "万象口袋InfoGenie后端 API 合集:健康检查、认证与用户、站点配置、管理端与 AI 应用。\n集合变量仅含 baseUrl生产默认。请在运行环境如 Apifox「环境」中配置 bearerToken萌芽 JWT与 siteAdminToken站点管理口令勿在集合里重复定义同名变量以免空值覆盖环境。\n需登录的接口已显式携带 Authorization: Bearer {{bearerToken}}。",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"variable": [
{
"key": "baseUrl",
"value": "https://infogenie.api.shumengya.top"
},
{
"key": "bearerToken",
"value": ""
}
],
"item": [
{
"name": "core",
"description": "服务根路径与健康检查。",
"item": [
{
"name": "服务信息",
"request": {
"method": "GET",
"header": [],
"url": "{{baseUrl}}/",
"description": "返回服务说明、版本与主要 API 路径摘要。"
}
},
{
"name": "健康检查",
"request": {
"method": "GET",
"header": [],
"url": "{{baseUrl}}/api/health",
"description": "数据库、Redis、60s 上游轻量探测与整体运行状态。"
}
}
]
},
{
"name": "auth",
"description": "登录态检测(可选 Token。",
"item": [
{
"name": "登录态检查",
"request": {
"method": "GET",
"header": [
{
"key": "Authorization",
"value": "Bearer {{bearerToken}}",
"type": "text"
}
],
"url": "{{baseUrl}}/api/auth/check",
"description": "OptionalJWT填写 bearerToken 可校验登录态;留空则返回 logged_in: false。"
}
}
]
},
{
"name": "user",
"description": "已登录用户资料(需萌芽认证 Token。",
"item": [
{
"name": "用户资料",
"request": {
"method": "GET",
"header": [
{
"key": "Authorization",
"value": "Bearer {{bearerToken}}",
"type": "text"
}
],
"url": "{{baseUrl}}/api/user/profile",
"description": "返回账号、昵称、邮箱、头像、等级、萌币与签到信息。"
}
}
]
},
{
"name": "site",
"description": "站点公开配置与功能卡片统计(无需登录)。",
"item": [
{
"name": "60s 隐藏功能列表",
"request": {
"method": "GET",
"header": [],
"url": "{{baseUrl}}/api/site/60s-disabled",
"description": "当前在前端隐藏的 60s 功能 id 列表。"
}
},
{
"name": "60s 上游节点",
"request": {
"method": "GET",
"header": [],
"url": "{{baseUrl}}/api/site/60s-source",
"description": "当前站点使用的 60s API 上游 base_url 与标签。"
}
},
{
"name": "AI 应用隐藏列表",
"request": {
"method": "GET",
"header": [],
"url": "{{baseUrl}}/api/site/ai-model-disabled",
"description": "当前隐藏的 AI 应用 id 列表。"
}
},
{
"name": "功能卡片点击统计",
"request": {
"method": "GET",
"header": [],
"url": "{{baseUrl}}/api/site/feature-card-clicks?section=60sapi",
"description": "查询某板块下各 item 点击次数。section60sapi | smallgame | toolbox | aimodel。"
}
},
{
"name": "功能卡片点击 +1",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"section\": \"60sapi\",\n \"item_id\": \"example-item-id\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": "{{baseUrl}}/api/site/feature-card-clicks/increment",
"description": "记录一次卡片点击并返回最新计数。"
}
}
]
},
{
"name": "admin-site",
"description": "站点管理(需请求头 X-Site-Admin-Token与 INFOGENIE_SITE_ADMIN_TOKEN 一致)。",
"item": [
{
"name": "写入 60s 隐藏列表",
"request": {
"method": "PUT",
"header": [
{
"key": "X-Site-Admin-Token",
"value": "{{siteAdminToken}}",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"disabled\": []\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": "{{baseUrl}}/api/admin/site/60s-disabled",
"description": "全量替换隐藏的 60s 功能 id 列表。"
}
},
{
"name": "切换 60s 上游节点",
"request": {
"method": "PUT",
"header": [
{
"key": "X-Site-Admin-Token",
"value": "{{siteAdminToken}}",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"source_id\": \"self\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": "{{baseUrl}}/api/admin/site/60s-source",
"description": "source_idself萌芽节点或 official官方节点。"
}
},
{
"name": "写入 AI 应用隐藏列表",
"request": {
"method": "PUT",
"header": [
{
"key": "X-Site-Admin-Token",
"value": "{{siteAdminToken}}",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"disabled\": []\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": "{{baseUrl}}/api/admin/site/ai-model-disabled",
"description": "全量替换隐藏的 AI 应用 id 列表。"
}
},
{
"name": "读取 AI 运行时配置",
"request": {
"method": "GET",
"header": [
{
"key": "X-Site-Admin-Token",
"value": "{{siteAdminToken}}",
"type": "text"
}
],
"url": "{{baseUrl}}/api/admin/site/ai-runtime",
"description": "读取数据库中的 AI 上游地址与密钥脱敏信息。"
}
},
{
"name": "写入 AI 运行时配置",
"request": {
"method": "PUT",
"header": [
{
"key": "X-Site-Admin-Token",
"value": "{{siteAdminToken}}",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"api_base\": \"\",\n \"api_key\": \"\",\n \"default_model\": \"\",\n \"default_provider\": \"deepseek\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": "{{baseUrl}}/api/admin/site/ai-runtime",
"description": "api_key 留空或不传则保留原密钥;勿将脱敏后的 **** 当作新密钥提交。"
}
},
{
"name": "诊断信息",
"request": {
"method": "GET",
"header": [
{
"key": "X-Site-Admin-Token",
"value": "{{siteAdminToken}}",
"type": "text"
}
],
"url": "{{baseUrl}}/api/admin/site/diagnostics",
"description": "连接配置摘要(不含密码/密钥明文)。"
}
}
]
},
{
"name": "aimodel",
"description": "AI 模型应用(需萌芽认证 Token。",
"item": [
{
"name": "对话",
"item": [
{
"name": "Chat 非流式",
"request": {
"method": "POST",
"header": [
{
"key": "Authorization",
"value": "Bearer {{bearerToken}}",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"用一句话介绍你自己。\"\n }\n ],\n \"provider\": \"deepseek\",\n \"model\": \"deepseek-chat\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": "{{baseUrl}}/api/aimodelapp/chat",
"description": "OpenAI 风格 messagesprovider/model 须在服务端白名单内。"
}
},
{
"name": "Chat 流式 SSE",
"request": {
"method": "POST",
"header": [
{
"key": "Authorization",
"value": "Bearer {{bearerToken}}",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "Accept",
"value": "text/event-stream",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"写一首四句短诗。\"\n }\n ],\n \"provider\": \"deepseek\",\n \"model\": \"deepseek-chat\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": "{{baseUrl}}/api/aimodelapp/chat/stream",
"description": "返回 text/event-streamSSE客户端需按流读取。"
}
}
]
},
{
"name": "应用",
"item": [
{
"name": "姓名分析",
"request": {
"method": "POST",
"header": [
{
"key": "Authorization",
"value": "Bearer {{bearerToken}}",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"name\": \"张晨曦\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": "{{baseUrl}}/api/aimodelapp/name-analysis",
"description": "姓名学与文化含义分析。"
}
},
{
"name": "变量命名建议",
"request": {
"method": "POST",
"header": [
{
"key": "Authorization",
"value": "Bearer {{bearerToken}}",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"description\": \"存储用户最近一次登录时间的字段\",\n \"language\": \"javascript\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": "{{baseUrl}}/api/aimodelapp/variable-naming",
"description": "按多种命名风格生成变量名建议。"
}
},
{
"name": "诗歌生成",
"request": {
"method": "POST",
"header": [
{
"key": "Authorization",
"value": "Bearer {{bearerToken}}",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"theme\": \"春雨与江南\",\n \"style\": \"现代诗\",\n \"mood\": \"宁静\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": "{{baseUrl}}/api/aimodelapp/poetry",
"description": "按主题、风格、情感基调作诗。"
}
},
{
"name": "多语言翻译",
"request": {
"method": "POST",
"header": [
{
"key": "Authorization",
"value": "Bearer {{bearerToken}}",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"source_text\": \"Hello, world!\",\n \"target_language\": \"zh-CN\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": "{{baseUrl}}/api/aimodelapp/translation",
"description": "翻译为指定目标语言JSON 结构化结果)。"
}
},
{
"name": "现代文转文言",
"request": {
"method": "POST",
"header": [
{
"key": "Authorization",
"value": "Bearer {{bearerToken}}",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"modern_text\": \"今天天气很好,我们去公园散步。\",\n \"style\": \"古雅\",\n \"article_type\": \"散文\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": "{{baseUrl}}/api/aimodelapp/classical_conversion",
"description": "现代文转文言文,返回 JSON 结构。"
}
},
{
"name": "表情符号生成",
"request": {
"method": "POST",
"header": [
{
"key": "Authorization",
"value": "Bearer {{bearerToken}}",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"text\": \"今天答辩顺利通过了!\",\n \"style\": \"mixed\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": "{{baseUrl}}/api/aimodelapp/expression-maker",
"description": "根据文案生成 emoji/颜文字等建议style 如 mixed、emoji、kaomoji 等。"
}
},
{
"name": "Linux 命令建议",
"request": {
"method": "POST",
"header": [
{
"key": "Authorization",
"value": "Bearer {{bearerToken}}",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"task_description\": \"查找当前目录下大于 10MB 的文件\",\n \"difficulty_level\": \"beginner\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": "{{baseUrl}}/api/aimodelapp/linux-command",
"description": "根据任务描述生成命令与安全提示等 JSON。"
}
},
{
"name": "Markdown 排版",
"request": {
"method": "POST",
"header": [
{
"key": "Authorization",
"value": "Bearer {{bearerToken}}",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"article_text\": \"第一段内容\\n\\n第二段内容\",\n \"emoji_style\": \"balanced\",\n \"markdown_option\": \"standard\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": "{{baseUrl}}/api/aimodelapp/markdown_formatting",
"description": "在不改写原文的前提下输出结构化 Markdown。"
}
},
{
"name": "亲属称呼计算",
"request": {
"method": "POST",
"header": [
{
"key": "Authorization",
"value": "Bearer {{bearerToken}}",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"relation_chain\": \"我妈妈的姐姐的儿子\",\n \"dialects\": [\"粤语\", \"闽南语\"]\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": "{{baseUrl}}/api/aimodelapp/kinship-calculator",
"description": "解析关系链,给出普通话及方言称呼 JSON。"
}
},
{
"name": "可用模型列表",
"request": {
"method": "GET",
"header": [
{
"key": "Authorization",
"value": "Bearer {{bearerToken}}",
"type": "text"
}
],
"url": "{{baseUrl}}/api/aimodelapp/models",
"description": "返回服务端允许的 provider 与 model 白名单。"
}
}
]
}
]
}
]
}