---
title: PreviewCard
description: 表示使用来自 URL 的 OpenGraph 标签生成的富媒体预览卡片。
menu:
docs:
parent: entities
aliases: [
"/entities/card",
"/entities/Card",
"/entities/previewcard",
"/entities/PreviewCard",
"/api/entities/card",
"/api/entities/Card",
"/api/entities/previewcard",
"/api/entities/PreviewCard",
]
---
## 示例
### 视频
```json
{
"url": "https://www.youtube.com/watch?v=OMv_EPMED8Y",
"title": "♪ Brand New Friend (Christmas Song!)",
"description": "",
"type": "video",
"author_name": "YOGSCAST Lewis & Simon",
"author_url": "https://www.youtube.com/user/BlueXephos",
"provider_name": "YouTube",
"provider_url": "https://www.youtube.com/",
"html": "",
"width": 480,
"height": 270,
"image": "https://files.mastodon.social/preview_cards/images/014/179/145/original/9cf4b7cf5567b569.jpeg",
"embed_url": "",
"blurhash": "UvK0HNkV,:s9xBR%njog0fo2W=WBS5ozofV@"
}
```
### 图片
```json
{
"url": "https://www.flickr.com/photos/tomfenskephotography/49088768431/",
"title": "Oregon",
"description": "",
"type": "photo",
"author_name": "Tom Fenske Photography",
"author_url": "https://www.flickr.com/photos/tomfenskephotography/",
"provider_name": "Flickr",
"provider_url": "https://www.flickr.com/",
"html": "",
"width": 1024,
"height": 427,
"image": "https://files.mastodon.social/preview_cards/images/014/287/139/original/651b1c6976817824.jpeg",
"embed_url": "https://live.staticflickr.com/65535/49088768431_6a4322b3bb_b.jpg",
"blurhash": "UnE{@jt6M_oIAhjYs+ayT2WBf9ayRkkDXAj["
}
```
### 链接
```json
{
"url": "https://www.theguardian.com/money/2019/dec/07/i-lost-my-193000-inheritance-with-one-wrong-digit-on-my-sort-code",
"title": "‘I lost my £193,000 inheritance – with one wrong digit on my sort code’",
"description": "When Peter Teich’s money went to another Barclays customer, the bank offered £25 as a token gesture",
"type": "link",
"authors": [],
"author_name": "",
"author_url": "",
"provider_name": "",
"provider_url": "",
"html": "",
"width": 0,
"height": 0,
"image": null,
"embed_url": "",
"blurhash": null
}
```
## 属性
### `url` {#url}
**描述:** 链接资源的地址。\
**类型:** 字符串 (URL)\
**版本历史:**\
1.0.0 - 添加
### `title` {#title}
**描述:** 链接资源的标题。\
**类型:** 字符串\
**版本历史:**\
1.0.0 - 添加
### `description` {#description}
**描述:** 预览的描述。\
**类型:** 字符串\
**版本历史:**\
1.0.0 - 添加
### `type` {#type}
**描述:** 预览卡片的类型。\
**类型:** 字符串 (可枚举, oneOf)\
`link` = 链接 OEmbed\
`photo` = 图片 OEmbed\
`video` = 视频 OEmbed\
`rich` = iframe OEmbed。当前不接受,因此实际上不会显示。\
**版本历史:**\
1.3.0 - 添加
### `authors` {#authors}
**描述:** 原始资源的作者的 Fediverse 账号。\
**类型:** Array of [PreviewCardAuthor]({{< relref "entities/PreviewCardAuthor">}})\
**版本历史:**\
4.3.0 - 添加
### `author_name` {#author_name}
**描述:** 原始资源的作者。自 4.3.0 起已弃用,客户端应改用 `authors`。\
**类型:** 字符串\
**版本历史:**\
1.3.0 - 添加\
4.3.0 - deprecated
### `author_url` {#author_url}
**描述:** 指向原始资源作者的链接。自 4.3.0 起已弃用,客户端应改用 `authors`。\
**类型:** 字符串 (URL)\
**版本历史:**\
1.3.0 - 添加\
4.3.0 - deprecated
### `provider_name` {#provider_name}
**描述:** 原始资源的提供者。\
**类型:** 字符串\
**版本历史:**\
1.3.0 - 添加
### `provider_url` {#provider_url}
**描述:** 指向原始资源提供者的链接。\
**类型:** 字符串 (URL)\
**版本历史:**\
1.3.0 - 添加
### `html` {#html}
**描述:** 用于生成预览卡片的 HTML。\
**类型:** 字符串 (HTML)\
**版本历史:**\
1.3.0 - 添加
### `width` {#height}
**描述:** 预览的宽度,以像素为单位。\
**类型:** 整数\
**版本历史:**\
1.3.0 - 添加
### `height` {#height}
**描述:** 预览的高度,以像素为单位。\
**类型:** 整数\
**版本历史:**\
1.3.0 - 添加
### `image` {#image}
**描述:** 预览缩略图。\
**类型:** {{}} 字符串 (URL)\
**版本历史:**\
1.0.0 - 添加
### `embed_url` {#embed_url}
**描述:** 用于照片嵌入,替代自定义的 `html`。\
**类型:** 字符串 (URL)\
**版本历史:**\
2.1.0 - 添加
### `blurhash` {#blurhash}
**描述:** 由 [BlurHash 算法](https://github.com/woltapp/blurhash)计算出的哈希值,用于在媒体尚未下载时生成彩色预览缩略图。\
**类型:** {{}} 字符串\
**版本历史:**\
3.2.0 - 添加
## Trends::Link 实体属性 {#trends-link}
```json
{
"url": "https://www.nbcnews.com/specials/plan-your-vote-2022-elections/index.html",
"title": "Plan Your Vote: 2022 Elections",
"description": "Everything you need to know about the voting rules where you live, including registration, mail-in voting, changes since 2020, and more.",
"type": "link",
"author_name": "NBC News",
"author_url": "",
"provider_name": "NBC News",
"provider_url": "",
"html": "",
"width": 400,
"height": 225,
"image": "https://files.mastodon.social/cache/preview_cards/images/045/027/478/original/0783d5e91a14fd49.jpeg",
"embed_url": "",
"blurhash": "UcQmF#ay~qofj[WBj[j[~qof9Fayofofayay",
"history": [
{
"day": "1661817600",
"accounts": "7",
"uses": "7"
},
{
"day": "1661731200",
"accounts": "23",
"uses": "23"
},
{
"day": "1661644800",
"accounts": "0",
"uses": "0"
},
{
"day": "1661558400",
"accounts": "0",
"uses": "0"
},
{
"day": "1661472000",
"accounts": "0",
"uses": "0"
},
{
"day": "1661385600",
"accounts": "0",
"uses": "0"
},
{
"day": "1661299200",
"accounts": "0",
"uses": "0"
}
]
}
```
### `history` {#history}
**描述:** 给定日期的使用统计信息(通常是过去一周)。\
**类型:** 哈希值的数组\
**版本历史:**\
3.5.0 - 添加
#### `history[][day]` {#history-day}
**描述:** 给定日期午夜的 UNIX 时间戳。\
**类型:** 字符串 (UNIX 时间戳)\
**版本历史:**\
3.5.0 - 添加
#### `history[][accounts]` {#history-accounts}
**描述:** 当天使用该链接的已计数帐户数。\
**类型:** 字符串 (从整数转换而来)\
**版本历史:**\
3.5.0 - 添加
#### `history[][uses]` {#history-uses}
**描述:** 当天使用该链接的已计数嘟文数。\
**类型:** 字符串 (从整数转换而来)\
**版本历史:**\
3.5.0 - 添加
## 参见
{{< page-relref ref="entities/Status#card" caption="Status (`card` 属性)" >}}
{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/preview_card_serializer.rb" caption="app/serializers/rest/preview_card_serializer.rb" >}}
{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/trends/link_serializer.rb" caption="app/serializers/rest/trends/link_serializer.rb" >}}
{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/models/trends/links.rb" caption="app/models/trends/links.rb" >}}
{{< translation-status-zh-cn raw_title="PreviewCard" raw_link="/entities/PreviewCard/" last_translation_time="2025-04-21" raw_commit="6addd5cf525adec1859f48c52dafcfe1f96e558a">}}