文件上传

概述

作品资源（行为包/资源包 .zip、.mcpack、图片等）需要先上传到网易文件服务器 （fp.ps.netease.com），拿到文件 URL 后再用于创建/更新作品。

上传接口

POST https://fp.ps.netease.com/x19/file/new/
Content-Type: multipart/form-data

字段	说明
Authorization	上传凭证，形如 Policy <sig>:<base64-json>
fpfile	文件本体（Content-Disposition 中带 filename 与 Content-Type）

上传凭证（token）解析

Authorization 值格式：Policy <sig>:<base64-json>

其中 base64 部分解码后是 JSON，包含实际上传地址：

{
  "url": "https://pfp.ps.netease.com/2024/07/01/xxxx.zip",
  "other": "..."
}

流程：

1. 用 filepicker/file_token 接口获取文件 token（或由上传前逻辑生成）
2. 解析 token 中的 url 字段 → 得到实际上传地址（不同 file_type 路由到不同子域）
   • zip_package → pfp.ps.netease.com
   • image → fp.ps.netease.com
3. 向该地址 POST 文件
4. 响应头 x-ntes-signature 为文件签名，保存备用
5. token 解析失败时回退默认地址 https://fp.ps.netease.com/x19/file/new/

获取文件 token

GET https://mc-launcher.webapp.163.com/filepicker/file_token

参数	类型	说明
file_type	string	文件用途：zip_package（作品资源包，路由到 pfp.ps.netease.com）、image（宣传图/授权图）、video（宣传视频）
secure	bool	是否安全模式，默认 false

{
  "status": "ok",
  "data": {
    "token": "Policy abc123:eyJ1cmwiOiJodHRwczovL3BmcC5wc...",
    "file_type": "zip_package",
    "secure": false
  }
}

不同 file_type 的 token 内 url 路由不同：zip_package → pfp.ps.netease.com；image/video → fp.ps.netease.com。

上传回执（FileInfoDTO）

上传完成后得到回执对象，用于填入 WorkCreateDTO.res[].res_url / channel[].channel_url / video_info_list：

{
  "body": "<文件服务器返回的JSON文本>",
  "file_type": "zip_package",
  "sign": "<x-ntes-signature 响应头值>"
}

字段	说明
body	上传响应体（<textarea> 包裹的 JSON 文本），内含文件最终 URL
file_type	与请求 file_type 一致
sign	响应头 x-ntes-signature 值，文件签名

新建作品时 res_url/channel_url 传 FileInfoDTO 对象；更新作品时则传 URL 字符串（从详情 res[].res_url 取）。

注意

• 上传超时建议放宽到 60s+（文件较大）
• 上传完成后，把返回的 URL 填入 WorkCreateDTO.res_url / WorkUpdateDTO.channel_url 等字段