Tumblr v2 API 封装库使用指南

Tumblr v2 API 是一个功能丰富的接口，允许开发者与 Tumblr 平台进行交互。下面我将介绍如何使用 Go 语言封装 Tumblr v2 API 的插件库。

安装

首先，你需要安装 Tumblr API 的 Go 客户端库：

go get github.com/tumblr/tumblrclient.go

基本使用

1. 初始化客户端

package main

import (
	"fmt"
	"github.com/tumblr/tumblrclient.go"
)

func main() {
	// 使用你的 Tumblr OAuth 凭证初始化客户端
	client := tumblrclient.NewClientWithToken(
		"your-consumer-key",
		"your-consumer-secret",
		"your-token",
		"your-token-secret",
	)

	// 测试连接
	userInfo, err := client.GetUserInfo()
	if err != nil {
		fmt.Printf("Error getting user info: %v\n", err)
		return
	}

	fmt.Printf("Logged in as: %s\n", userInfo.Name)
}

2. 获取博客信息

func getBlogInfo(client *tumblrclient.Client, blogName string) {
	blogInfo, err := client.GetBlogInfo(blogName)
	if err != nil {
		fmt.Printf("Error getting blog info: %v\n", err)
		return
	}

	fmt.Printf("Blog Title: %s\n", blogInfo.Title)
	fmt.Printf("Description: %s\n", blogInfo.Description)
	fmt.Printf("URL: %s\n", blogInfo.Url)
}

3. 创建文本帖子

func createTextPost(client *tumblrclient.Client, blogName string) {
	params := map[string]string{
		"type":   "text",
		"title":  "Hello from Go",
		"body":   "This is a test post created using the Tumblr API v2 and Go!",
		"state":  "published", // 或 "draft"
		"tags":   "go,golang,tumblr",
	}

	_, err := client.Post(blogName, params)
	if err != nil {
		fmt.Printf("Error creating post: %v\n", err)
		return
	}

	fmt.Println("Post created successfully!")
}

高级功能

1. 分页获取帖子

func getPosts(client *tumblrclient.Client, blogName string) {
	params := map[string]string{
		"limit": "20",    // 每页数量
		"offset": "0",    // 起始位置
		"filter": "text", // 只获取文本帖子
	}

	posts, err := client.GetPosts(blogName, params)
	if err != nil {
		fmt.Printf("Error getting posts: %v\n", err)
		return
	}

	for _, post := range posts {
		fmt.Printf("Post ID: %s, Title: %s\n", post.Id, post.Title)
	}
}

2. 上传图片

func createPhotoPost(client *tumblrclient.Client, blogName string, imagePath string) {
	params := map[string]string{
		"type":        "photo",
		"caption":     "Uploaded from Go",
		"tags":        "go,programming",
		"source":      imagePath, // 本地文件路径或URL
		"data":       imagePath, // 对于本地文件
	}

	_, err := client.Post(blogName, params)
	if err != nil {
		fmt.Printf("Error creating photo post: %v\n", err)
		return
	}

	fmt.Println("Photo post created successfully!")
}

3. 获取关注列表

func getFollowing(client *tumblrclient.Client) {
	following, err := client.GetFollowing()
	if err != nil {
		fmt.Printf("Error getting following list: %v\n", err)
		return
	}

	fmt.Println("Following these blogs:")
	for _, blog := range following.Blogs {
		fmt.Printf("- %s (%s)\n", blog.Name, blog.Url)
	}
}

错误处理

func handleErrors(err error) {
	if err != nil {
		if apiErr, ok := err.(*tumblrclient.ApiError); ok {
			fmt.Printf("Tumblr API Error: %d - %s\n", apiErr.Status, apiErr.Msg)
		} else {
			fmt.Printf("Error: %v\n", err)
		}
	}
}

完整示例

package main

import (
	"fmt"
	"github.com/tumblr/tumblrclient.go"
)

func main() {
	client := tumblrclient.NewClientWithToken(
		"your-consumer-key",
		"your-consumer-secret",
		"your-token",
		"your-token-secret",
	)

	// 获取用户信息
	userInfo, err := client.GetUserInfo()
	handleErrors(err)
	fmt.Printf("Logged in as: %s\n", userInfo.Name)

	// 获取默认博客信息
	blogName := userInfo.Blogs[0].Name
	getBlogInfo(client, blogName)

	// 创建文本帖子
	createTextPost(client, blogName)

	// 获取最近的帖子
	getPosts(client, blogName)
}

func handleErrors(err error) {
	if err != nil {
		if apiErr, ok := err.(*tumblrclient.ApiError); ok {
			fmt.Printf("Tumblr API Error: %d - %s\n", apiErr.Status, apiErr.Msg)
		} else {
			fmt.Printf("Error: %v\n", err)
		}
	}
}

注意事项

1. 确保你已经在 Tumblr 开发者门户注册了应用并获取了 OAuth 凭证
2. 遵守 Tumblr 的 API 使用限制和条款
3. 对于生产环境，考虑添加重试机制和速率限制
4. 敏感信息如 API 密钥应存储在环境变量中而非代码中

这个封装库提供了 Tumblr API 的大部分功能，你可以根据需要扩展它或直接使用它来构建 Tumblr 相关的应用。