个人 API

创建联合兼容发布记录

POST /v1/personal/resources/{slug}/release
POST/v1/personal/resources/{slug}/release
下载规范

一条发布记录的加载器与游戏版本为联合约束;需要精确配对时提交多个 compat 项。

Bearer 令牌(resource:update:self)

路径参数

slugstring必填

长度 ≥ 1

请求体 必填

application/json
bodyobject

方案 1 · object

versionNumberstring必填

长度 ≥ 1 · 长度 ≤ 200

releaseTypestring可选
可选值"release""beta""alpha"
environmentstring可选
可选值"client_only""server_only""dedicated_server_only""client_or_server""unknown"
statusstring可选
可选值"listed""archived""unlisted""draft""scheduled"
publishedAtstring可选
namestring可选
changelogstring可选
installNotestring可选
referencesobject[]可选

条目数 ≤ 200

[]object

方案 1 · object

relationstring可选

长度 ≤ 100

rolestring可选
kindstring可选
notestring可选
externalUrlstring可选

格式:uri

targetTypestring必填
可选值"resource""tutorial""post"
targetIdstring必填

方案 2 · object

relationstring可选

长度 ≤ 100

rolestring可选
kindstring可选
notestring可选
externalUrlstring可选

格式:uri

targetTypestring必填
可选值"resource""tutorial""post"
targetIdstring必填
fragmentTypestring必填
可选值"release""section""block"
fragmentIdstring必填

方案 3 · object

relationstring可选

长度 ≤ 100

rolestring可选
kindstring可选
notestring可选
externalUrlstring可选

格式:uri

externalNamestring必填

长度 ≥ 1 · 长度 ≤ 200

externalKeystring可选
compatobject[]必填

条目数 ≥ 1 · 条目数 ≤ 64

loadersstring[]必填

条目数 ≥ 1

[]string
mcVersionsstring[]必填

条目数 ≥ 1

[]string
versionGroupstring可选

游戏版本体系 slug;请求省略时按 Java 版处理。

长度 ≥ 2 · 长度 ≤ 64 · 格式:^[a-z][a-z0-9-]{1,63}$

filesobject[]必填

条目数 ≥ 1 · 条目数 ≤ 64

[]object

方案 1 · object

uploadIdstring必填
isPrimaryboolean可选

方案 2 · object

sha512string必填

格式:^[0-9a-fA-F]{128}$

filenamestring必填

长度 ≤ 255

sizeinteger必填

≥ 0

urlstring必填

格式:uri

formatstring可选

长度 ≤ 32

isPrimaryboolean可选

方案 2 · object

versionNumberstring必填

长度 ≥ 1 · 长度 ≤ 200

releaseTypestring可选
可选值"release""beta""alpha"
environmentstring可选
可选值"client_only""server_only""dedicated_server_only""client_or_server""unknown"
statusstring可选
可选值"listed""archived""unlisted""draft""scheduled"
publishedAtstring可选
namestring可选
changelogstring可选
installNotestring可选
referencesobject[]可选

条目数 ≤ 200

[]object

方案 1 · object

relationstring可选

长度 ≤ 100

rolestring可选
kindstring可选
notestring可选
externalUrlstring可选

格式:uri

targetTypestring必填
可选值"resource""tutorial""post"
targetIdstring必填

方案 2 · object

relationstring可选

长度 ≤ 100

rolestring可选
kindstring可选
notestring可选
externalUrlstring可选

格式:uri

targetTypestring必填
可选值"resource""tutorial""post"
targetIdstring必填
fragmentTypestring必填
可选值"release""section""block"
fragmentIdstring必填

方案 3 · object

relationstring可选

长度 ≤ 100

rolestring可选
kindstring可选
notestring可选
externalUrlstring可选

格式:uri

externalNamestring必填

长度 ≥ 1 · 长度 ≤ 200

externalKeystring可选
compatobject[]必填

条目数 ≥ 1 · 条目数 ≤ 64

loadersstring[]必填

条目数 ≥ 1

[]string
mcVersionsstring[]必填

条目数 ≥ 1

[]string
versionGroupstring可选

游戏版本体系 slug;请求省略时按 Java 版处理。

长度 ≥ 2 · 长度 ≤ 64 · 格式:^[a-z][a-z0-9-]{1,63}$

fileobject必填

方案 1 · object

uploadIdstring必填
isPrimaryboolean可选

方案 2 · object

sha512string必填

格式:^[0-9a-fA-F]{128}$

filenamestring必填

长度 ≤ 255

sizeinteger必填

≥ 0

urlstring必填

格式:uri

formatstring可选

长度 ≤ 32

isPrimaryboolean可选

方案 3 · object

versionNumberstring必填

长度 ≥ 1 · 长度 ≤ 200

releaseTypestring可选
可选值"release""beta""alpha"
environmentstring可选
可选值"client_only""server_only""dedicated_server_only""client_or_server""unknown"
statusstring可选
可选值"listed""archived""unlisted""draft""scheduled"
publishedAtstring可选
namestring可选
changelogstring可选
installNotestring可选
referencesobject[]可选

条目数 ≤ 200

[]object

方案 1 · object

relationstring可选

长度 ≤ 100

rolestring可选
kindstring可选
notestring可选
externalUrlstring可选

格式:uri

targetTypestring必填
可选值"resource""tutorial""post"
targetIdstring必填

方案 2 · object

relationstring可选

长度 ≤ 100

rolestring可选
kindstring可选
notestring可选
externalUrlstring可选

格式:uri

targetTypestring必填
可选值"resource""tutorial""post"
targetIdstring必填
fragmentTypestring必填
可选值"release""section""block"
fragmentIdstring必填

方案 3 · object

relationstring可选

长度 ≤ 100

rolestring可选
kindstring可选
notestring可选
externalUrlstring可选

格式:uri

externalNamestring必填

长度 ≥ 1 · 长度 ≤ 200

externalKeystring可选
loadersstring[]必填

条目数 ≥ 1

[]string
mcVersionsstring[]必填

条目数 ≥ 1

[]string
filesobject[]必填

条目数 ≥ 1 · 条目数 ≤ 64

[]object

方案 1 · object

uploadIdstring必填
isPrimaryboolean可选

方案 2 · object

sha512string必填

格式:^[0-9a-fA-F]{128}$

filenamestring必填

长度 ≤ 255

sizeinteger必填

≥ 0

urlstring必填

格式:uri

formatstring可选

长度 ≤ 32

isPrimaryboolean可选

方案 4 · object

versionNumberstring必填

长度 ≥ 1 · 长度 ≤ 200

releaseTypestring可选
可选值"release""beta""alpha"
environmentstring可选
可选值"client_only""server_only""dedicated_server_only""client_or_server""unknown"
statusstring可选
可选值"listed""archived""unlisted""draft""scheduled"
publishedAtstring可选
namestring可选
changelogstring可选
installNotestring可选
referencesobject[]可选

条目数 ≤ 200

[]object

方案 1 · object

relationstring可选

长度 ≤ 100

rolestring可选
kindstring可选
notestring可选
externalUrlstring可选

格式:uri

targetTypestring必填
可选值"resource""tutorial""post"
targetIdstring必填

方案 2 · object

relationstring可选

长度 ≤ 100

rolestring可选
kindstring可选
notestring可选
externalUrlstring可选

格式:uri

targetTypestring必填
可选值"resource""tutorial""post"
targetIdstring必填
fragmentTypestring必填
可选值"release""section""block"
fragmentIdstring必填

方案 3 · object

relationstring可选

长度 ≤ 100

rolestring可选
kindstring可选
notestring可选
externalUrlstring可选

格式:uri

externalNamestring必填

长度 ≥ 1 · 长度 ≤ 200

externalKeystring可选
loadersstring[]必填

条目数 ≥ 1

[]string
mcVersionsstring[]必填

条目数 ≥ 1

[]string
fileobject必填

方案 1 · object

uploadIdstring必填
isPrimaryboolean可选

方案 2 · object

sha512string必填

格式:^[0-9a-fA-F]{128}$

filenamestring必填

长度 ≤ 255

sizeinteger必填

≥ 0

urlstring必填

格式:uri

formatstring可选

长度 ≤ 32

isPrimaryboolean可选

返回值

成功

okboolean必填
可选值true
slugstring必填
versionNumberstring必填
releasesstring[]必填
[]string
接口信息

接口: POST /v1/personal/resources/{slug}/release
operationId: createRelease

所需权限: resource:update:self

一条发布记录的加载器与游戏版本为联合约束;需要精确配对时提交多个 compat 项。

参数:

  • path slug(必填)
  • body versionNumber
  • body releaseType
  • body environment
  • body status
  • body publishedAt
  • body name
  • body changelog
  • body installNote
  • body references
  • body compat
  • body files
  • body file
  • body loaders
  • body mcVersions