文档 API v2createMyNews

createMyNews

提交资讯

任何已登录用户都可以投稿到 community 来源(缺省值)：条目落入 pending，由审核员发布后才上线；在滑动窗口内用满 catalog.news_submissions_per_day 的账号会被拒以 429 QUOTA_EXCEEDED。合作方来源必须绑定到持有者且为 active；其条目落入 pending，来源受信任时直接落为 published。需要用户访问令牌。

post/v2/me/news

Authorization: Bearer <用户访问令牌>（用户授权后的访问令牌,不是 API 密钥）

参数

参数	类型	位置	说明
`Idempotency-Key`	`string`	`header`	让请求可以安全重试。24 小时内同一把键配同一请求体，会带着 Idempotency-Replayed: true 重放第一次的响应；同一把键配不同请求体是 409 IDEMPOTENCY_KEY_REUSED；第一次请求还在处理时重试是 409 IDEMPOTENCY_REQUEST_IN_PROGRESS。范围限定为调用方与路径。

请求体

application/json

banner_hashstring
横幅的哈希，取自 POST /v2/me/news-images 的返回值。不是由该接口存入的哈希会被拒为 422 VALIDATION_FAILED，reason 为 UNKNOWN_REFERENCE。
bodystring
条目自己的正文，CommonMark Markdown，最多 20000 个 rune(超出则 422 TOO_LONG)。只有社区投稿可以携带。不得用作判别条件。
lanestring
来源的栏目。缺省为 news。
枚举newscolumn
published_atstringdate-time
RFC 3339。缺省为提交时刻。
sourcestring
资讯来源键。省略即为 community，任何已登录用户都可以投稿到它。其他来源必须以发布者身份绑定到持有者且为 active。
source_urlstring
指向原始条目的规范链接，须为绝对 http(s) URL。合作方来源必填，其署名始终带有链接；原创社区投稿可省略。不得用作判别条件。
summarystring 必填
导语。最多 200 个 rune；超出则 422 VALIDATION_FAILED，reason 为 TOO_LONG。不得用作判别条件。
titlestring 必填
不得用作判别条件。
work_idsstring[]
要关联的作品 id。以 manual 置信度存储。

响应

请求示例

cURL

curl -X POST "https://api.nextmoe.dev/v2/me/news" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"summary":"string","title":"string"}'