A Go Tumblr API v2 Client.
In terminal write go get github.com/MariaTerzieva/gotumblr
Run the tests with go test to check if everything is ok.
To use this package in your projects do this (after install):
import "github.com/MariaTerzieva/gotumblr"
You are going to need a consumer key, consumer secret, callback URL, token and token secret. You can get the consumer key, consumer secret and callback URL by registering a Tumblr application. You can do so by clicking here. The token and token secret you can get by using OAUTH. If you want to use this package just for your own tumblr account, after registering the application, click on the Explore API option and allow it access to your Tumblr account. You are going to see a tab "Show keys". Click on it and you will get your token and token secret but if you want, you can also obtain them using OAUTH.
First import the package in your project as shown above.
Then create NewTublrRestClient with your credentials(consumer key, consumer secret, token, token secret and callback url):
client := gotumblr.NewTumblrRestClient("consumer_key", "consumer_secret", "token", "token_secret", "callback_url", "http://api.tumblr.com")
Then use the client you just created to get the information you need. Here are some examples with what I got for my account:
info := client.Info()
fmt.Println(info.User.Name)
//Output:
//mgterzieva
likes := client.Likes(map[string]string{})
fmt.Println(likes.Liked_count)
//Output:
//63
following := client.Following(map[string]string{})
fmt.Println(following.Total_blogs)
//Output:
//1
dashboard := client.Dashboard(map[string]string{"limit": "1"})
if len(dashboard.Posts) != 0 {
var base_dashboard_post gotumblr.BasePost
for i, _ := range dashboard.Posts {
json.Unmarshal(dashboard.Posts[i], &base_dashboard_post)
fmt.Println(base_dashboard_post.State)
//Output:
//published
}
}
tagged := client.Tagged("golang", map[string]string{"limit": "1"})
if len(tagged) != 0 {
var base_tagged_post gotumblr.BasePost
for i, _ := range tagged {
json.Unmarshal(tagged[i], &base_tagged_post)
fmt.Println(base_tagged_post.State)
//Output:
//published
}
}
blogname := "mgterzieva.tumblr.com" //this is my blogname. Change this according to your usecase and credentials.
blogInfo := client.BlogInfo(blogname)
fmt.Println(blogInfo.Blog.Title)
//Output:
//Maria's blog
followers := client.Followers(blogname, map[string]string{})
fmt.Println(followers.Total_users)
//Output:
//0
blog_likes := client.BlogLikes(blogname, map[string]string{})
fmt.Println(blog_likes.Liked_count)
//Output:
//63
queue := client.Queue(blogname, map[string]string{})
fmt.Println(len(queue.Posts))
//Output:
//0
drafts := client.Drafts(blogname, map[string]string{})
fmt.Println(len(drafts.Posts))
//Output:
//6
submission := client.Submission(blogname, map[string]string{})
fmt.Println(len(submission.Posts))
//Output:
//0
avatar := client.Avatar(blogname, 64)
fmt.Println(avatar.Avatar_url)
//Output:
//http://25.media.tumblr.com/avatar_49f49d0b9209_64.png
other_blogname := "http://thehungergamesmovie.tumblr.com"
follow := client.Follow(other_blogname)
fmt.Println(follow)
//Output:
//<nil>
unfollow := client.Unfollow(other_blogname)
fmt.Println(unfollow)
//Output:
//<nil>
id := "72078164824" //this is the id of a post of mine. Change this according to your usecase.
//There is an Id field in all of the post object types in this library.
reblogKey := "6l3e2pGL" //this is the reblogKey of a post of mine. Change this according to your usecase.
//There is a Reblog_key field in all of the post object types in this library.
like := client.Like(id, reblogKey)
fmt.Println(like)
//Output:
//<nil>
unlike := client.Unlike(id, reblogKey)
fmt.Println(unlike)
//Output:
//<nil>
reblog := client.Reblog(blogname, map[string]string{"id": id, "reblog_key": reblogKey})
fmt.Println(reblog)
//Output:
//<nil>
state := "draft"
textPost := client.CreateText(blogname, map[string]string{"body": "Hello happy world!", "state": state})
fmt.Println(textPost)
//Output:
//<nil>
quote := "A happy heart makes the face cheerful."
source := "Proverbs 15:13"
quotePost := client.CreateQuote(blogname, map[string]string{"quote": quote, "source": source, "state": state})
fmt.Println(quotePost)
//Output:
//<nil>
title := "Follow me on tumblr, guys! :)"
url := "http://mgterzieva.tumblr.com"
linkPost := client.CreateLink(blogname, map[string]string{"url": url, "title": title, "state": state})
fmt.Println(linkPost)
//Output:
//<nil>
conversation := "John Doe: Hi there!\nJane Doe: Hi, John!\nJane Doe: ♥♥♥"
//separate the tags with commas and don't leave whitespaces around the commas
tags := "Saint Valentine's day,14th of February,lots of love,xoxo"
chatPost := client.CreateChatPost(blogname, map[string]string{"conversation": conversation, "tags": tags, "state": state})
fmt.Println(chatPost)
//Output:
//<nil>
text := "Hello happy world!" //if you are editing a text post
editPost := client.EditPost(blogname, map[string]string{"id": id, "body": text})
fmt.Println(editPost)
//Output:
//<nil>
deletePost := client.DeletePost(blogname, id)
fmt.Println(deletePost)
//Output:
//<nil>
code := `<iframe width="560" height="315" src="//www.youtube.com/embed/uJNvZRAmeqY" frameborder="0" allowfullscreen></iframe>`
caption := "<b>Mother knows best</b>"
embedVideo := client.CreateVideo(blogname, map[string]string{"embed": code, "state": state, "caption": caption})
fmt.Println(embedVideo)
//Output:
//<nil>
song := "https://soundcloud.com/tiffany-alvord-song/the-one-that-got-away-cover-by"
songPostByURL := client.CreateAudio(blogname, map[string]string{"external_url": song, "state": state})
fmt.Println(songPostByURL)
//Output:
//<nil>
picture := "http://thumbs.dreamstime.com/z/cute-panda-17976617.jpg"
photoPostByURL := client.CreatePhoto(blogname, map[string]string{"source": picture, "state": state})
fmt.Println(photoPostByURL)
//Output:
//<nil>
If you still don't get how to work with this package don't worry! :) Read the project documentation or the Tumblr API or write an e-mail at mgterzieva@abv.bg if these don't help. :)
In case you find any issues with this code, use the project's Issues page to report them or send pull requests.
Copyright 2014 Maria Terzieva
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.