掌握tumblr.js核心功能：用户信息、博客数据与内容发布全攻略

【免费下载链接】tumblr.jsJavaScript client for the Tumblr API项目地址: https://gitcode.com/gh_mirrors/tu/tumblr.js

tumblr.js是一款强大的JavaScript客户端库，专为Tumblr API设计，让开发者能够轻松实现用户信息获取、博客数据管理和内容发布等核心功能。无论是构建第三方应用还是自动化工具，tumblr.js都提供了简洁高效的接口，帮助你快速集成Tumblr平台的各项能力。

快速入门：安装与初始化

一键安装步骤

使用npm即可快速安装tumblr.js：

npm install --save tumblr.js

最快配置方法

安装完成后，通过以下代码初始化客户端。你需要提供从Tumblr开发者控制台获取的API密钥（consumer_key）：

const tumblr = require('tumblr.js'); const client = tumblr.createClient({ consumer_key: 'YOUR_CONSUMER_KEY' });

对于需要用户认证的操作（如发布内容），还需提供完整的OAuth1凭证（consumer_secret、token和token_secret）。

用户信息管理：了解你的受众

获取当前用户资料

通过userInfo方法可以获取认证用户的基本信息及其管理的博客列表：

client.userInfo() .then(info => console.log('用户信息:', info)) .catch(err => console.error('获取失败:', err));

该方法对应源码中的lib/tumblr.js#L780-L782实现，返回用户ID、名称、博客列表等关键数据。

查看用户关注列表

使用userFollowing方法获取用户关注的博客：

client.userFollowing({ limit: 20 }) .then(following => console.log('关注列表:', following)) .catch(err => console.error('获取失败:', err));

支持通过limit和offset参数分页获取结果，帮助你构建完整的社交关系图谱。

管理用户喜欢内容

tumblr.js提供了点赞和取消点赞的功能：

// 点赞 postId 为 12345 的帖子 client.likePost('12345', 'reblog_key_here') .then(response => console.log('点赞成功:', response)) .catch(err => console.error('点赞失败:', err)); // 取消点赞 client.unlikePost('12345', 'reblog_key_here');

这些功能在lib/tumblr.js#L597-L612中实现，需要完整的OAuth1认证。

博客数据操作：掌握内容生态

获取博客基本信息

使用blogInfo方法获取指定博客的详细信息：

client.blogInfo('staff.tumblr.com') .then(info => console.log('博客信息:', info)) .catch(err => console.error('获取失败:', err));

返回数据包括博客标题、描述、关注者数量、帖子总数等关键指标，对应源码lib/tumblr.js#L675-L677。

高效获取博客文章

通过blogPosts方法获取博客文章，支持按类型筛选和分页：

client.blogPosts('staff.tumblr.com', { type: 'photo', limit: 10, offset: 20 }) .then(posts => console.log('照片帖子:', posts)) .catch(err => console.error('获取失败:', err));

该方法在lib/tumblr.js#L707-L709中实现，支持多种筛选参数，满足不同场景需求。

图：Tumblr平台上的博客内容示例，通过tumblr.js可以轻松获取和管理这类内容

管理博客互动数据

获取博客的点赞和关注者数据：

// 获取博客点赞内容 client.blogLikes('staff.tumblr.com', { limit: 10 }) .then(likes => console.log('博客点赞:', likes)) .catch(err => console.error('获取失败:', err)); // 获取博客关注者 client.blogFollowers('staff.tumblr.com', { limit: 20 }) .then(followers => console.log('博客关注者:', followers)) .catch(err => console.error('获取失败:', err));

这些方法在lib/tumblr.js#L688-L703中实现，帮助你分析博客的受众互动情况。

内容发布：创建与管理帖子

发布NPF格式内容

Tumblr推荐使用Neue Post Format (NPF)发布内容，支持多种媒体类型：

client.createPost('my-blog.tumblr.com', { content: [ { type: 'text', text: '这是一篇通过tumblr.js发布的帖子' }, { type: 'image', media: fs.createReadStream('./image.jpg'), alt_text: '图片描述' } ], tags: ['tumblr.js', 'api', '测试'] }) .then(response => console.log('发布成功:', response)) .catch(err => console.error('发布失败:', err));

createPost方法在lib/tumblr.js#L498-L501中实现，支持文本、图片、视频等多种内容块组合。

编辑与删除帖子

管理已发布的内容：

// 编辑帖子 client.editPost('my-blog.tumblr.com', 'post_id_here', { content: [{ type: 'text', text: '更新后的内容' }] }) .then(response => console.log('编辑成功:', response)) .catch(err => console.error('编辑失败:', err)); // 删除帖子 client.deletePost('my-blog.tumblr.com', 'post_id_here') .then(response => console.log('删除成功:', response)) .catch(err => console.error('删除失败:', err));

这些方法需要用户对目标博客有管理权限，对应源码lib/tumblr.js#L515-L518和lib/tumblr.js#L647-L649。

高级应用：探索更多可能性

搜索标签内容

使用taggedPosts方法获取特定标签的公开内容：

client.taggedPosts('javascript', { limit: 10 }) .then(posts => console.log('JavaScript相关帖子:', posts)) .catch(err => console.error('搜索失败:', err));

该功能在lib/tumblr.js#L829-L839中实现，可用于内容发现和趋势分析。

批量处理与自动化

结合Node.js的异步特性，可以实现批量操作：

// 批量获取多个博客信息 const blogNames = ['staff.tumblr.com', 'tech.tumblr.com']; Promise.all(blogNames.map(name => client.blogInfo(name))) .then(infos => console.log('多个博客信息:', infos)) .catch(err => console.error('批量获取失败:', err));

这种方式可以高效管理多个博客账号或进行数据分析。

项目资源与贡献

tumblr.js是一个开源项目，你可以通过以下方式获取更多资源或参与贡献：

• 源码仓库：通过git clone https://gitcode.com/gh_mirrors/tu/tumblr.js获取完整代码
• 类型定义：项目提供完整的TypeScript类型定义lib/types.ts
• 测试用例：参考test/tumblr.test.mjs了解功能测试方法
• 贡献指南：查看CONTRIBUTING.md了解如何参与项目开发

无论你是开发新手还是经验丰富的开发者，tumblr.js都提供了清晰的接口和完善的文档，帮助你快速集成Tumblr API，构建丰富多样的应用。立即开始探索，释放Tumblr平台的无限可能！

【免费下载链接】tumblr.jsJavaScript client for the Tumblr API项目地址: https://gitcode.com/gh_mirrors/tu/tumblr.js