导入
API 对象详情
获取与 GIPHY API 调用相关的重要对象的详细信息。
| 名称 | 类型 | 描述 |
|---|---|---|
| type | string | 用于标识返回的对象是 GIF 还是贴纸。type 的默认值几乎总是 gif。 |
| id | string | 这是 GIF 的唯一 ID。 |
| url | string | 这是 GIF 的唯一 URL。 |
| slug | string | Slug 是 URL 中用于标识网站上特定页面的部分，对用户友好。这是 GIF URL 中使用的唯一 slug。例如，若 URL 为：http://giphy.com/gifs/confused-flying-YsTs5ltWtEhnq，那么其 slug 就是 confused-flying-YsTs5ltWtEhnq。 |
| bitly_gif_url | string | 这是 GIF 的唯一 "bit.ly" URL。 |
| bitly_url | string | 这是 GIF 的唯一 "bit.ly" URL。 |
| embed_url | string | 用于嵌入 GIF 的 URL。 |
| username | string | 这是 GIF 所属频道的用户名。仅在适用时存在。 |
| source | string | 这是 GIF 所在的网页来源。例如，GIF 的来源可以是 Reddit、HBO Max、giphy.com 等。 |
| title | string | 这是 GIF 在 giphy.com 上显示的标题。 |
| rating | string | 这是 GIF 内容的 MPAA（美国电影协会）风格评级。有效值包括 g、pg、pg-13 和 r。 |
| content_url | string | 此字段目前未被 giphy.com 使用。 |
| source_tld | string | 这是来源 URL 的顶级域名。例如，若来源帖子的 URL 是 http://giphy.com/5282328320，那么 source_tld 就是 giphy.com。 |
| source_post_url | string | 这是 GIF 所在网页的 URL。 |
| is_sticker | integer | 该标志用于判断返回的对象是 GIF 还是贴纸。返回 GIF 时值为 0，返回贴纸时值为 1。 |
| update_datetime | string | 这是 GIF 最后更新的日期。 |
| create_datetime | string | 这是 GIF 被添加到 GIPHY 数据库的日期。 |
| import_datetime | string | 该值表示 GIF 在其原始来源创建或上传的时间和日期。例如，一个 GIF 在 Reddit 上于 2021-08-01 12:41:48 创建或上传。 |
| trending_datetime | string | 该值表示 GIF 在 giphy.com 上被标记为热门的时间。仅在适用时存在。 |
| analytics_response_payload | string | 这是 GIF 的分析响应数据包。 |
| images | object | 该对象包含关于各种可用 GIF 大小和格式的数据。 |
| user | object | 该对象包含与 GIF 相关的用户信息（如果适用）。通常为在 giphy.com 上创建或上传 GIF 的人。 |
| analytics | object | 该对象包含用于记录用户行为的数据，如查看、点击或发送 GIF 的时间。 |
| 名称 | 类型 | 描述 |
|---|---|---|
| offset | integer (int32) | 这是分页中的位置。 |
| total_count | integer (int32) | 这是 GIPHY 数据库中可用项目的总数。请注意，此数字也包括每个端点未返回的项目。 |
| count | integer (int32) | 这是单次响应中返回的项目总数。 |
| 名称 | 类型 | 描述 |
|---|---|---|
| msg | string | 这是 HTTP 响应消息。例如，请求成功时返回 "OK"。 |
| status | integer (int32) | 这是 HTTP 响应码。例如，请求成功时返回 200。 |
| response_id | string | 这是与 API 响应配对的唯一 ID。 |
...
| 名称 | 类型 | 描述 |
|---|---|---|
| avatar_url | string | 这是用户的头像图片 URL。 |
| banner_url | string | 这是用户个人资料页顶部显示的横幅图片 URL。 |
| profile_url | string | 这是用户在 GIPHY 上的个人资料 URL。 |
| username | string | 这是用户在 GIPHY 上的用户名。 |
| display_name | string | 这是用户在 GIPHY 上的显示名称。可能包含比基础用户名更丰富的格式信息。例如，用户名为 "joecool4000"，而 display_name 为 "JoeCool4000"。 |
| 名称 | 类型 | 描述 |
|---|---|---|
| name | string | 这是分类名称。例如，“动作”、“卡通与漫画”、“名人”等。 |
| name_encoded | string | 这是分类名称的编码形式。例如，“cartoons & comics” 的 name_encoded 为 “cartoons-comics”。 |
| 名称 | 类型 | 描述 |
|---|---|---|
| id | number | 这是频道在 GIPHY 上的唯一 ID。 |
| url | string | 这是频道的相对 URL。例如，“/giphystudios”。 |
| display_name | string | 这是频道的显示名称。例如，“GIPHY Studios”。 |
| parent | number | 这是该频道的父频道 ID。 |
| slug | string | 这是频道 URL 中的唯一频道 slug。例如，“giphystudios” 是 “/giphystudios” 中的 slug。 |
| type | string | 这是频道的类型。例如，“社区”频道或“品牌”频道。“品牌”频道用于公司、音乐艺人、演员或公众人物。 |
| content_type | string | 这是该频道提供的内容类型。例如，频道的内容类型可以是 gif 或 sticker。 |
| banner_image | string | 这是频道横幅图片的 URL。 |
| short_display_name | string | 这是频道的简短显示名称。 |
| description | string | 这是频道的描述，可能包含频道的主要信息和背景介绍。 |
| metadata_description | string | 这是频道的元数据描述，可能说明频道生产的内容类型。例如，“我们只制作 GIF” 或 “我们制作 GIF 和贴纸”。 |
| has_children | boolean | 该标志表示该频道是否有子频道。 |
| is_visible | boolean | 该标志表示该频道是否可见。 |
| is_private | boolean | 该标志表示该频道是否为私有。 |
| is_live | boolean | 该标志表示该频道是否为直播状态。 |
| analytics_response_payload | string | 这是结果的响应数据包。 |
| screensaver_gif | string | 这是用作频道屏保的 GIF 的 ID。 |
| ancestors | object | 这是该频道的父频道列表。 |
| tags | object | 这是频道可同步的标签列表。 |
| featured_gif | object | 这是一个包含频道精选 GIF 数据的对象。 |
| user | object | 这是一个包含与该频道关联的用户数据的对象。 |
| 名称 | 类型 | 描述 |
|---|---|---|
| id | number | 这是标签的唯一 ID。 |
| channel | number | 这是与标签关联的频道 ID。 |
| rank | number | 这是标签的排名。 |
| tag | string | 这是标签本身的值。例如，“happy”。 |