个人 API
创建资源
POST /v1/personal/resources
POST
/v1/personal/resourcesBearer 令牌(resource:create)
请求体 必填
application/jsontitlestring必填长度 ≥ 1 · 长度 ≤ 120
summarystring必填长度 ≥ 1 · 长度 ≤ 200
bodystring必填长度 ≥ 1 · 长度 ≤ 1000000
slugstring可选长度 ≤ 100 · 格式:^[a-z0-9]+(?:-[a-z0-9]+)*$
coverUrlstring可选格式:uri
capabilitiesobject可选
capabilitiesobject可选[key]any可选tagsstring | string[]可选多值可重复传入同名参数,或用逗号分隔;同一筛选维度内满足任意值即可。
tagsstring | string[]可选多值可重复传入同名参数,或用逗号分隔;同一筛选维度内满足任意值即可。
方案 1 · string
多值可重复传入同名参数,或用逗号分隔;同一筛选维度内满足任意值即可。
bodystring多值可重复传入同名参数,或用逗号分隔;同一筛选维度内满足任意值即可。
方案 2 · string[]
多值可重复传入同名参数,或用逗号分隔;同一筛选维度内满足任意值即可。
bodystring[]多值可重复传入同名参数,或用逗号分隔;同一筛选维度内满足任意值即可。
bodystring[]多值可重复传入同名参数,或用逗号分隔;同一筛选维度内满足任意值即可。
[]stringreferencesobject[]可选条目数 ≤ 200
referencesobject[]可选[]object
[]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可选statusstring可选可选值
"draft""published"返回值
成功
okboolean必填可选值
trueidstring必填slugstring必填接口信息
接口: POST /v1/personal/resources
operationId: createResource
所需权限: resource:create
参数:
bodytitlebodysummarybodybodybodyslugbodycoverUrlbodycapabilitiesbodytags:多值可重复传入同名参数,或用逗号分隔;同一筛选维度内满足任意值即可。bodyreferencesbodystatus