可用的API接口如下:
描述:此接口用于获取原始帖子并保存为档案帖子item。
请求路径:api/v1/posts/save
请求方法:POST
请求参数:
参数名 | 类型 | 说明 | 是否必要 | 注释 |
---|---|---|---|---|
url |
str |
需要被存档的URL。 | 是 | 可以接受这些类型的URL: |
`tumblr.com/todayontumblr |
tumblr.com/todayontumblr/735720326113132544
tumblr.com/todayontumblr/735720326113132544/flowerytale-sylvia-plath-from-a-letter-t
www.tumblr.com/todayontumblr/735720326113132544
www.tumblr.com/todayontumblr/735720326113132544/flowerytale-sylvia-plath-from-a-letter-to-ann
todayontumblr.tumblr.com/735720326113132544
todayontumblr.tumblr.com/735720326113132544/flowerytale-sylvia-plath-from-a-letter-to-ann| |
start_time|
str| 若url为blogname型,则为需要获取的帖子的发布时间范围的开始;否则无意义。 | 若url为blogname型,则是;否则为否。 |
YYYY-MM-DD| |
end_time|
str| 若url为blogname型,则为需要获取的帖子的发布时间范围的结束;否则无意义。 | 若url为blogname型,则是;否则为否。 |
YYYY-MM-DD| |
tags|
str或
array| 需要被存档的item的被指定tag | 否 |
XX或
AA,BB,CC` |
响应格式:
字段 | 类型 | 说明 | 注释 |
---|---|---|---|
meta |
obj |
元信息 | |
meta.status |
num |
状态信息 | 200:成功 |
400:请求参数错误 | |||
403:API无效 | |||
404:没有结果 | |||
429:达到API速率上限 | |||
500:未知错误 | |||
503:维护中 | |||
504:响应超时 | |||
meta.msg |
str |
状态信息 | 已成功获取到XX条帖子,用时XX秒,点此查看 |
日期填写有误
URL填写有误
tags填写有误
API KEY无效,请联系管理员
没有获取到任何帖子
已达到速率上限,请稍等一段时间后重试(一般情况下是一小时左右)
未知错误,请联系管理员
维护中,请稍晚重试
网络响应超时,请稍后重试 |
| response
| obj
| 返回内容 | |
| respone.posts
| array
| 返回的帖子列表 | |
respone.post
内的数组数据:
字段 | 类型 | 说明 | 是否一定存在 | 注释 |
---|---|---|---|---|
name |
num |
帖子id | 是 | |
status |
num |
状态信息 | 是 | 200:相同id不同内容的档案,已更新 |
201:新的档案,已添加 | ||||
204:相同id相同内容的档案,不用更新 | ||||
ver |
num |
帖子档案item的版本 | 否 | 当status 为200时,包含此字段。 |
从1开始自增,包括1 |
| archive_timestamp
| num
| 帖子档案item的存档时间 | 是 | 时间戳 |
| data
| obj
| 帖子数据 | 否 | 当status
为200或201时,包含此字段。 |
描述:此接口用于检索并展示帖子档案item。
请求路径:api/v1/posts/show
请求方法:GET
请求参数:
参数名 | 类型 | 说明 | 是否必要 | 注释 |
---|---|---|---|---|
id |
num |
需要获取的item的帖子id | 否 | |
blogname |
str |
需要获取的item归属的博客的名称 | 否 | XX .tumblr.com的XX |
XX
或AA,BB,CC
|
| ver
| num
| 需要获取的item的ver | 否 | |
| start_time
| str
| 需要获取的item归属的发布时间范围的开始 | 否 | YYYY-MM-DD
|
| end_time
| str
| 需要获取的item归属的发布时间范围的结束 | 否 | YYYY-MM-DD
|
| tags
| str
| 需要获取的item的被指定tag | 否 | XX
或AA,BB,CC
|
| limit
| num
| 每次返回的item数上限 | 否 | 1-100(默认100) |
| page
| num
| 要返回的页数 | 否 | (默认1) |
| start
| num
| 需要获取的item归属的id的开始 | 否 | |
| end
| num
| 需要获取的item归属的id的结束 | 否 | |
| type
| str
| 需要获取的item归属的原始类型 | 否 | text
, quote
, link
, answer
, video
, audio
, photo
, chat
XX
或AA,BB,CC
(默认返回所有类型) |
| sort
| str
| 返回的帖子item排列方式 | 否 | asc
或desc
asc
:帖子id正序(小在前大在后)
desc
:帖子id倒序(大在前小在后)
(默认正序) |
响应格式:
字段 | 类型 | 说明 | 注释 |
---|---|---|---|
meta |
obj |
元信息 | |
meta.status |
num |
状态信息 | 200:成功 |
404:没有结果 | |||
response |
obj |
返回内容 | |
respone.posts |
array |
返回的帖子列表 |
respone.post
内的数组数据:
字段 | 类型 | 说明 | 注释 |
---|---|---|---|
_id |
str |
唯一id | 由mongodb自动生成 |
name |
num |
帖子id | |
ver |
num |
帖子档案item的版本 | 从1开始自增,包括1 |
first_archive_timestamp |
num |
相同帖子档案iitem的第一次存档时间 | 时间戳 |
last_archive_timestamp |
num |
相同帖子item的最后一次存档时间 | 时间戳 |
data |
obj |
帖子数据 |
data
内的数据:
字段 | 类型 | 说明 | 是否一定存在 | 注释 |
---|---|---|---|---|
type |
str |
帖子类型 | 是 | 恒为blocks |
original_type |
str |
原始帖子类型 | 是 | text , photo , quote , chat , link , video , audio |
is_blocks_post_format |
bool |
帖子格式是否为NPF | 是 | 恒为true |
blog_name |
str |
博客的标识符 | 是 | XX.tumblr.com的XX |
blog |
obj |
博客数据 | 是 | |
id |
num |
帖子id | 是 | |
id_string |
str |
帖子id | 是 | |
is_blazed |
bool |
是否热推过 | 是 | |
is_blaze_pending |
bool |
是否热推中 | 是 | |
can_blaze |
bool |
可以被热推吗 | 是 | 可以:true |
不可以:false |
||||
post_url |
str |
帖子的网址 | 是 | https://<str:博客名>.tumblr.com/post/<int:帖子id>/<str:帖子的摘要> |
slug |
str |
帖子的摘要 | 是 | 看这里 |
帖子创建时自动生成,用于url中 | ||||
date |
str |
帖子的发布时间 | 是 | 看这里 |
YYYY-MM-DD hh:mm:ss GMT |
||||
timestamp |
num |
帖子的发布时间 | 是 | 时间戳 |
state |
str |
帖子的发布状态 | 是 | 恒为published |
reblog_key |
str |
转发此帖子所需的键值 | 是 | |
tags |
array |
帖子指定的标签 | 是 | 看这里 |
short_url |
str |
帖子的短网址 | 是 | https://tmblr.co/<str> |
summary |
str |
帖子的摘要 | 是 | 帖子创建时自动生成 |
should_open_in_legacy |
bool |
(?) | 是 | 貌似恒为true |
recommended_source |
null |
(?) | 是 | 貌似恒为null |
recommended_color |
null |
(?) | 是 | 貌似恒为null |
note_count |
num |
(?) | 是 | |
content |
array |
帖子内容块 | 否 | 看这里 |
layout |
array |
帖子内容块的布局信息 | 否 | |
trail |
array |
帖子的转发内容 | 否 | |
reblogged_from_id |
str |
最晚转发的帖子id | 否 | |
reblogged_from_url |
str |
最晚转发的帖子url | 否 | |
reblogged_from_name |
str |
最晚转发的帖子归属博客的名称 | 否 | |
reblogged_from_title |
str |
最晚转发的帖子归属博客指定的标题 | 否 | |
reblogged_from_uuid |
str |
最晚转发的帖子归属博客的UUID | 否 | |
reblogged_from_can_message |
bool |
最晚转发的帖子归属博客是否允许私信 | 否 | |
reblogged_root_id |
str |
最早转发的帖子id | 否 | |
reblogged_root_url |
str |
最早转发的帖子url | 否 | |
reblogged_root_name |
str |
最早转发的帖子归属博客的名称 | 否 | |
reblogged_root_title |
str |
最早转发的帖子归属博客指定的标题 | 否 | |
reblogged_root_uuid |
str |
最早转发的帖子归属博客的UUID | 否 | |
reblogged_root_can_message |
bool |
最早转发的帖子归属博客是否允许私信 | 否 | |
can_like |
bool |
是否允许喜欢 | 是 | |
interactability_reblog |
str |
谁可以在转发博客时与之互动 | 是 | 'everyone' 或'noone' |
interactability_blaze |
str |
(?) | 是 | |
can_reblog |
bool |
(?) | 是 | |
can_send_in_message |
bool |
(?) | 是 | |
can_reply |
bool |
(?) | 是 | |
display_avatar |
bool |
(?) | 是 |
blog
内的数据:
字段 | 类型 | 说明 | 是否一定存在 | 注释 |
---|---|---|---|---|
name |
str |
博客的标识符 | 是 | XX .tumblr.com的XX |
title |
str |
博客指定的标题 | 是 | |
description |
str |
博客指定的描述 | 是 | |
url |
str |
博客的标准网址 | 是 | XX.tumblr.com |
uuid |
str |
博客的UUID | 是 | 当博客名称被更改时,这个值不会改变。 |
updated |
num |
博客发布最后一条帖子的时间 | 是 | 时间戳 |
tumblrmart_accessories |
obj |
(?) | 是 | 貌似恒为{} |
can_show_badges |
bool |
博客指定的勋章展示状态 | 是 | 展示勋章:true |
不展示勋章:false |
content
内的数组数据:
(未完待续…)