LogShare.CN

API 文档

轻松粘贴或上传您的 Minecraft/Hytale 日志以进行分享和分析。 LogShare.CN 直接集成到您的服务器面板、托管软件或任何其他平台中。此平台专为高性能自动化而构建，可通过我们的 HTTP API 轻松集成到任何现有软件中。

快速接入

接入「日志上传 + AI 分析」的最小流程：上传后使用返回的 token 删除日志（丢失无法找回，请自行持久化）；系统全链路默认采用 Brotli（br）压缩，客户端默认推荐使用 Content-Encoding: br 压缩上传（亦兼容 gzip）；服务端出站响应全链路默认以 br 压缩返回；客户端读超时建议 300 秒以上（Agent 多轮工具分析可能持续数十秒）。

cURL 
# 1. 上传日志（系统默认采用 Brotli 压缩；亦支持未压缩纯文本或 JSON）
brotli -c server.log | curl -X POST https://api.logshare.cn/v1/log      -H 'Content-Type: text/plain'      -H 'Content-Encoding: br'      -H 'Accept-Encoding: br, gzip'      --data-binary @-
# 或普通 JSON 模式：
# curl -X POST https://api.logshare.cn/v1/log -H 'Content-Type: application/json' -d '{"content":"<日志全文>","source":"your-launcher/1.0.0"}'
# → {"success":true,"id":"sAbCdEf","token":"...","raw":"...","url":"..."}

# 2. 获取原始日志或结构化解析（可选）
curl https://api.logshare.cn/v1/raw/sAbCdEf          # 日志原文
curl https://api.logshare.cn/v1/insights/sAbCdEf     # Codex 结构化分析

# 3. AI 深度分析（SSE 流式，读超时建议 ≥300s）
curl -N https://api.logshare.cn/v1/ai/sAbCdEf

API 基础信息

基础 URL
https://api.logshare.cn
API 版本
v1
协议
HTTPS
认证
无需认证（公共 API）

所有 API 请求均使用 HTTPS 协议，HTTP 请求会被自动重定向到 HTTPS。全局限流按 IP + 方法 + 归一化路径计数，默认每 IP 每方法每路径 36,000 次/60 秒，触发返回 HTTP 429。

可用端点

方法端点描述
POST/v1/log提交日志
POST/v1/analyse分析日志（本地 Codex）
GET/v1/raw/{id}获取原始日志
GET/v1/insights/{id}获取日志分析结果
GET/v1/raw/{id}/{filename}获取日志附加文件
GET/v1/log/{id}获取日志元信息与文件列表
DELETE/v1/log/{id}删除日志
GET/v1/limits获取限制信息
GET/v1/filters获取过滤器信息
GET/v1/ai/{id}AI 分析已存储日志（SSE 流式输出）
POST/v1/ai/analyseAI 分析日志内容（SSE 流式输出）