个人 API

创建帖子

POST /v1/personal/posts
POST/v1/personal/posts
下载规范

Bearer 令牌(post:create)

请求体 必填

application/json
bodyobject

方案 1 · object

bodystring必填

长度 ≥ 1 · 长度 ≤ 1000000

refstring可选
primaryRefobject可选
typestring必填
可选值"resource""tutorial"
idstring必填
tagsstring | string[]可选

多值可重复传入同名参数,或用逗号分隔;同一筛选维度内满足任意值即可。

方案 1 · string

多值可重复传入同名参数,或用逗号分隔;同一筛选维度内满足任意值即可。

bodystring

多值可重复传入同名参数,或用逗号分隔;同一筛选维度内满足任意值即可。

方案 2 · string[]

多值可重复传入同名参数,或用逗号分隔;同一筛选维度内满足任意值即可。

bodystring[]

多值可重复传入同名参数,或用逗号分隔;同一筛选维度内满足任意值即可。

[]string
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可选
titlestring可选

长度 ≤ 120

needsHelpboolean可选
可选值false

方案 2 · object

bodystring必填

长度 ≥ 1 · 长度 ≤ 1000000

refstring可选
primaryRefobject可选
typestring必填
可选值"resource""tutorial"
idstring必填
tagsstring | string[]可选

多值可重复传入同名参数,或用逗号分隔;同一筛选维度内满足任意值即可。

方案 1 · string

多值可重复传入同名参数,或用逗号分隔;同一筛选维度内满足任意值即可。

bodystring

多值可重复传入同名参数,或用逗号分隔;同一筛选维度内满足任意值即可。

方案 2 · string[]

多值可重复传入同名参数,或用逗号分隔;同一筛选维度内满足任意值即可。

bodystring[]

多值可重复传入同名参数,或用逗号分隔;同一筛选维度内满足任意值即可。

[]string
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可选
titlestring必填

长度 ≥ 1 · 长度 ≤ 120

statestring可选
可选值"open""resolved""closed"
needsHelpboolean可选
bountyobject可选
amountinteger必填

> 0

返回值

成功

okboolean必填
可选值true
idstring必填
接口信息

接口: POST /v1/personal/posts
operationId: createPost

所需权限: post:create

参数:

  • body body
  • body ref
  • body primaryRef
  • body tags:多值可重复传入同名参数,或用逗号分隔;同一筛选维度内满足任意值即可。
  • body references
  • body title
  • body needsHelp
  • body state
  • body bounty