api.jpg (42.4 kB)

今回のリリース内容

本日 esa API v1をβ公開しました。
大変長らくお待たせしました。

まずは記事APIとチームAPIを公開しましたが、今後もAPIで操作可能な対象を増やしていくつもりです。

ss 2015-05-24 at 23.06.28.png (374.8 kB)

APIについて、詳しくはこちらのドキュメントを御覧ください

dev/api/v1 - docs.esa.io

「ぜひこのAPIを追加してくれ!」や「このパラメータも欲しいんだけど」みたいなことがありましたら、ぜひ右下のFeedback formからお知らせ下さい。

また、Rubyのesa API clientも先日から公開していますのでissueやpull-requestをお待ちしております。

esaio/esa-ruby

このgemの使い方はこんな感じです。

require 'esa'

client = Esa::Client.new(access_token: "<access_token>", current_team: 'foo')
client.teams
#=> GET /v1/teams

client.team('bar')
#=> GET /v1/teams/bar

client.posts
#=> GET /v1/teams/foo/posts

client.posts(q: 'in:help')
#=> GET /v1/teams/foo/posts?q=in%3Ahelp

client.current_team = 'foobar'
client.post(1)
#=> GET /v1/teams/foobar/posts/1

client.create_post(name: 'foo')
#=> POST /v1/teams/foobar/posts

client.update_post(1, name: 'bar')
#=> PATCH /v1/teams/foobar/posts/1

client.delete_post(1)
#=> DELETE /v1/teams/foobar/posts/1

所感

APIを公開することで、esaの使い方の可能性が広がるのが楽しみです。
「うちのチームではこういうの作ったぜ!」という事例を是非お知らせください。

APIのprivate βにご協力して頂いた皆様ありがとうございました。


[ProTip] Webhookでdocs.esa.ioの更新通知を受け取れるようになりました!

Enjoy "(\( ⁰⊖⁰)/)"
https://esa.io

Comments0