本接口适用于MOD开发者、自动化工具、服务器MOD等场景，支持直接上传Minecraft进度json文件并获取可分享的分析链接。
接口地址
POST /api/upload_share
- Content-Type: multipart/form-data
- 参数：file（必填，上传的json文件），language（可选，"cn"或"en"，默认cn，后期可切换。）
请求示例（curl）
curl -X POST \
-F "file=@你的advancements.json" \
-F "language=cn" \
https://lookatthesky.cn/api/upload_share
返回示例
{
"success": true,
"share_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"share_url": "https://lookatthesky.cn/share.html?share_id=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"share_date": "2024-07-01 12:34:56 (UTC+8)",
"expire_date": "2024-07-04 12:34:56 (UTC+8)"
}
参数说明
- file：Minecraft进度json文件，必须为标准json格式，且内容为对象类型，大小不超过1MB。
- language：分析语言，可选"cn"（中文）或"en"（英文），默认"cn"，后期可切换。
注意事项
- 只支持json文件，其他类型会被拒绝。
- 文件大小不能超过1MB。
- 内容必须能被json解析且为对象类型。
- 分享链接有效期为3天，过期后无法访问。
- 如需批量或自动化集成，可直接用脚本调用本接口。
隐私提示：请勿上传包含敏感信息的文件，分享链接公开可访问。
常见问题
- Q: 上传后如何查看？
A: 返回的 share_url 即为可访问的分析页面，直接在浏览器打开即可。
- Q: 支持哪些Minecraft版本？
A: 只要是Java版标准进度json，理论上都支持。
- Q: 有API速率限制吗？
A: 别把我服务器整爆炸了随便用。
This API is for mod developers, automation tools, or server mods. You can directly upload a Minecraft advancement json file and get a shareable analysis link.
Endpoint
POST /api/upload_share
- Content-Type: multipart/form-data
- Params: file (required, the json file to upload), language (optional, "cn" or "en", default is cn, can be switched later.)
Request Example (curl)
curl -X POST \
-F "file=@your_advancements.json" \
-F "language=en" \
https://lookatthesky.cn/api/upload_share
Response Example
{
"success": true,
"share_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"share_url": "https://lookatthesky.cn/share.html?share_id=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"share_date": "2024-07-01 12:34:56 (UTC+8)",
"expire_date": "2024-07-04 12:34:56 (UTC+8)"
}
Parameter Description
- file: Minecraft advancement json file, must be valid json object, max size 1MB.
- language: Analysis language, "cn" (Chinese) or "en" (English), default is "cn", can be switched later.
Notes
- Only json files are supported, other types will be rejected.
- File size must not exceed 1MB.
- Content must be a valid json object.
- Share links are valid for 3 days, after which they expire.
- For batch or automated integration, you can call this API via script.
Privacy Notice: Do not upload files containing sensitive information. Share links are public.
FAQ
- Q: How to view after upload?
A: The returned share_url is the analysis page, open it in your browser.
- Q: Which Minecraft versions are supported?
A: Any standard Java advancement json file is supported in theory.
- Q: Is there an API rate limit?
A: No special limit. Feel free to use it, just don't melt my server.