ページを指定できるAPIでは、ページネーションの情報を含んだレスポンスを返します。クライアントライブラリクライアントライブラリ現時点で以下のライブラリが利用可能です。APIを利用するには、アクセストークンをリクエストに含める必要があります。アクセストークンは、ユーザの管理画面(https://[team].esa.io/user/tokens)から発行できます。βでは一部のチームでのみトークンが発行可能です。OAuthを利用した認可フローは今後対応予定です。トークントークンアクセストークンは、以下のようにリクエストヘッダに含められます。1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdefまた、URIクエリ文字列として指定することも可能です。スコープスコープ個々のアクセストークンには、複数のスコープを紐付けることができます。アクセストークンが適切なスコープを持っている時のみAPIを利用することができます。APIでは以下のスコープを利用することができます。OAuthOAuth今後実装予定です。チームチームesa上で所属しているチームを表します。(String)チームを特定するための一意なIDです。サブドメインになります。(String)チームの公開範囲です。"チームメンバーだけが情報にアクセスできます。"ShipItされた記事はインターネット上に公開されます。記事記事ユーザが作成した記事を表します。(String)記事名です。タグやカテゴリー部分は含みません。String)記事に紐付けられたタグです。(String)カテゴリとタグを含む、記事名です。Progress)状態かどうかを表します。(String)HTMLに変換された記事の本文です。String)記事が更新された日時です。(String)記事更新時の変更メモです。section"revision_number(Integer)記事のリビジョン番号です。(Object)記事を作成したユーザを表します。(String)ユーザ名です。(String)ユーザを一意に識別するIDです。(String)ユーザのアイコンのURLです。(Object)記事を最後に更新したユーザを表します。/api/v1/teams/:team_name/posts/:post_number指定された投稿を取得します。/api/v1/teams/:team_name/posts記事を新たに投稿します。指定することで記事の投稿者を上書きすることができます。使用することができます。/api/v1/teams/:team_name/posts/:post_number指定された投稿を編集します。mergeが行われます。original_revisionパラメータが存在しない場合は、変更は常に後勝ちになります。/api/v1/teams/:team_name/posts/:post_number指定された投稿を削除します。コメントコメントユーザが作成したコメントを表します。(Object)コメントを作成したユーザを表します。(String)ユーザ名です。(String)ユーザを一意に識別するIDです。(String)ユーザのアイコンのURLです。/api/v1/teams/:team_name/posts/:post_number/comments記事のコメント一覧を更新日の降順で返却します。/api/v1/teams/:team_name/comments/:comment_id指定されたコメントを取得します。/api/v1/teams/:team_name/posts/:post_number/comments記事に新しいコメントを作成します。指定することで記事の投稿者を上書きすることができます。使用することができます。/api/v1/teams/:team_name/comments/:comment_id指定されたコメントを更新します。/api/v1/teams/:team_name/comments/:comment_id指定されたコメントを削除します。v1について説明します。ベータ期間中もできるだけ非互換の変更は避けるつもりですが、APIの仕様を変更することがありますので適宜この記事を確認して下さい。APIおよびAPIドキュメントをより良いものにしたいと考えております。些細なものでも構いませんので、沢山のフィードバックをお待ちしております。v1のβ期間は2015-08-31までを予定しています。プロトコルを使用します。HTTPメソッドを利用します。多くのAPIはリクエスト時にパラメータを含められますが、GETリクエストにはURIクエリ文字列を利用し、それ以外の場合にはリクエストボディを利用します。パラメータにはページネーション等の任意で渡すものと、記事名等の必須のものが存在します。現時点では、ユーザ毎に15分間に75リクエストまで受け付けます。βテスト期間を通じて適切な値に調整したいと考えています。