getNewsItem
获取一条资讯
一条已发布的情报。已撤回的条目返回 410 GONE 而非 404:只看到条目从列表里消失的镜像,永远不会知道它已经取走的副本被撤下了。从不存在的 id、以及仍在待审的条目,返回 404。无需凭证。source 与 source_url 永远存在;原创社区投稿的 source_url 为空字符串,改由 body 承载正文。
/v2/news/{id}参数
| 参数 | 类型 | 位置 | 说明 |
|---|---|---|---|
id 必填 | string | path | 十进制资讯条目 id。 |
响应
bannerobject必填 可空头图。该条目没有头图时为 null。
hashstring必填图床内容哈希。
heightintegerint64 必填 可空像素高度。未知则为 null。
sexualstring必填 可空性描写。null 表示未评估。
枚举safesuggestiveexplicitsourcestring必填开放词表来源。不得用作判别条件。
thumbhashstring必填 可空Thumbhash。未知则为 null。
urlstringuri 必填图片的绝对 URL。从不为裸 hash。
violencestring必填 可空暴力描写。null 表示未评估。目前没有任何 catalog 行经过评估;该值恒为 null。
枚举tameviolentbrutalwidthintegerint64 必填 可空像素宽度。未知则为 null。
bodystring条目自己的正文,CommonMark Markdown,最多 20000 个 rune。只出现在 GET /v2/news/{id},且仅当 has_body 为 true;列表不携带它。请按不可信的用户内容渲染:不得渲染原始 HTML。不得用作判别条件。
has_bodyboolean必填条目是否带有自己的正文。只有社区投稿会带;合作方条目就是摘要加 source_url。
idstring必填资讯条目 id。
lanestring必填授权方自己把这条归入的栏目。月幕的两个上游端点载荷完全相同,栏目是唯一能把它们分开的东西。
枚举newscolumnobjectstring必填类型判别字段。恒为 news_item。
枚举news_itempublished_atstringdate-time 必填RFC 3339 UTC。
sourceobject必填attributionstring必填转载说明,授权方自己写的原文。请随条目一同展示,不要自行拼写。不可用作判别依据。
column_urlstringuri 必填该源的专栏索引。源没有专栏时为空串。
display_namestring必填不得用作判别条件。
homepage_urlstringuri 必填来源自己的站点主页。该来源没有时为空字符串。
namestring必填来源键。
objectstring必填类型判别字段。恒为 news_source。
枚举news_source
source_urlstringuri 必填指向原始条目的规范链接。原创社区投稿在别处没有原文,此时为空字符串。
submitter_uidstring必填 可空经 /v2/me/news 投稿该条目的账号:NextMoe 各站共用的中央登录用户 id。从合作方导入的条目为 null。
summarystring必填来源提供的导语。不得用作判别条件。
titlestring必填不得用作判别条件。
请求示例
curl "https://api.nextmoe.dev/v2/news/1"