Go言語でRESTful APIクライアント: Qiita APIを叩いてみよう!

この記事の目的

Go言語で Qiita API のRESTful APIを叩いてトークンを取れるようになる

Qiita APIの仕様

token取得

POST /api/v1/auth

認証: ユーザー名+パスワードによる認証

input

• url_name (必須) String
  • Qiitaのユーザー名(twittername or githubname@github)
• password (必須) String

response

Status: 200 OK

{
  "url_name": "yourname",
  "token": "yoursecrettoken"
}

---

エラー時のレスポンス

APIのリクエストに失敗したときはステータスコード400/403/404でエラーメッセージが以下の形式で返される．

{"error": "Required key `url_name` is missing."}

実装してみる

RESTful APIクライアントライブラリは github.com/jmcvetta/napping を使う。

main.go

package main

import (
    "log"
    "github.com/jmcvetta/napping"
)

func main() {
    urlName := "suin" // ここは自分のものに
    password := "p@ssW0rd" // ここは自分のものに

    // 入力JSONのフォーマットを定義 & 初期化
    input :=  struct {
        UrlName string `json:"url_name"` // JSONのキーと構造体のキーが一致しないものは、ここでマッピングする 
        Password string `json:"password"` // 同上
    } {
        urlName,
        password,
    }

    // 正常時のJSONのフォーマットを定義 & 初期化
    // Qiitaからのレスポンスには url_name も含まれるが、必要ないのでここでは定義しない
    response := struct {
        Token string
    } {}

    // エラー時のJSONのフォーマットを定義 & 初期化
    error := struct {
        Error string
    } {}

    resp, err := napping.Post("https://qiita.com/api/v1/auth", &input, &response, &error) // input, response, errorは参照を渡す

    if err != nil {
        panic(err)
    }

    log.Printf("status: %#v", resp.Status())
    log.Printf("token: %#v", response.Token)
    log.Printf("error message: %#v", error.Error)
}

実行してみる

go run main.go

結果

2013/12/11 21:07:42 status: 200
2013/12/11 21:07:42 token: "d61c32d3f02543b39d61e9b545c58d0c"
2013/12/11 21:07:42 error message: ""