medium

go-medium

go-medium is a Medium API client for Go.

As you know, Medium provides an official API client for Go, literally named medium-sdk-go. However, that client is not able to publish an article to the authorized user's publications. I decided to implement alternative Go client for Medium.

Installation

$ go install github.com/moutend/go-medium

Usage

First off, you need initialize a client like this:

c := medium.NewClient(clientID, clientSecret, accessToken)

It's not recommended but if you want to use self-issued token, set clientID and clientSecret blank.

go-medium doesn't provide a method for generating API token with client ID and client secret. However, it provides Token method which generates a new API token based off shortlive code and redirect URI. One way to generate API token with OAuth is launching the local web server and redirect HTTP request to that web server.

In the following example, it demonstrates the steps below:

• Initialize a client with self-issued token.
• Get information about current authorized user.
• Get publications owned by current authorized user.
• Create an article as Markdown format.
• Post the article to the publication.

package main

import (
	"fmt"
	"log"

	medium "github.com/moutend/go-medium"
)

func main() {
	// It's not recommended, but it uses self-issued token in this example.
	accessToken := "self-issued-access-token"
	c := medium.NewClient("", "", accessToken)

	// Get information about current authorized user.
	// See user.go to check all exported fields.
	u, err := c.User()
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("You are logged in as %s.", u.Username)

	// Get list of publications.
	ps, err := u.Publications()
	if err != nil {
		log.Fatal(err)
	}
	// It assumes that the user has one or more publications.
	// See publication.go to check all exported fields.
	if len(ps) == 0 {
		log.Fatalf("%s has no publications yet.\n", u.Username)
	}
	fmt.Printf("You have a publication named %s.\n", ps[0].Name)

	// Publish an article as Markdown format.
	// For more dail, see next section.
	article := medium.Article{
		Title:         "test",
		ContentFormat: "markdown",
		Content: `# Test

## Sub title

# Using Medium API

This article was published from command line.`,
	}
	// Publish an article to the first publication.
	// See article.go to check all exported fields of PostedArticle.
	pa, err := ps[0].Post(article)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("Published an article at %s\n", a.URL)
}

Specifying PublishedAt

The default value of medium.Article.PublishedAt is current time, you don't have to specify when the article was published at. However, if you want to specify it, the timestamp must be formatted according to the layout below:

2006-01-02T15:04:05+07000

Valid range of published date

Note that you cannot specify the timestamp after current UTC+07:00. I don't know why but it will be treated as future post and Medium API will reject that post. For example, Japan standard Time is UTC+09:00, the article posted from machine which timezone is set as JST will be rejected.

Also, you cannot specify the date and time before Jan 1st, 1970.

LICENSE

MIT