くりにっき

フルスタックキュアエンジニアです

AZusaar!! のPARTAKEユーザイベント APIの仕様について

API AZusaar

需要あるかどうか分かりませんが一応まとめておきます

概要

  • PARTAKEのユーザIDから、参加・開催しているイベントを取得します
    • User API の /api/user/events と /api/user/tickets ã‚’AZusaar!!のサーバサイドでラップしています
  • レスポンスはJSONとJSONPだけに対応しています
  • 基本的にはATND API（以降ATND仕様）に準拠していますが、AZusaar!!で必要のない項目は削っています
  • 同じ名前のパラメータでも意味が違うものがあるのでご注意を

API詳細

リクエストURL

PARTAKE
http://azusaar.appspot.com/api/partakeUser

検索クエリ

パラメータ 項目名 説明
user_id 参加者のユーザID
owner_id 主催者のユーザID PARTAKE APIでいうところのowner(主催者)とeditor(編集者)の両方を取得します
ym 検索対象年月 YYYYMMで指定(例:201206)。省略時は年月で絞り込みません
callback JSONPのコールバック関数名 callbackがある場合はJSONP, ない場合はJSONで返却
  • 他のイベント検索APIと違ってページングはありません
    • ページングするだけの量もないだろうしｗ
  • user_idとowner_idはどちらか1つだけ指定できます

サンプルクエリ

PARTAKE
http://azusaar.appspot.com/api/partakeUser?user_id=247fe915-dc36-4a9a-a01a-0f6347105633

レスポンスフィールド

フィールド 説明 備考
results_returned 含まれる検索結果の件数
results_start 検索の開始位置 ページングがないので0で固定
event [複数要素]
└ title タイトル
└ event_url PARTAKEのイベントページのURL
└ started_at イベント開催日時 「2012-06-20T19:30:00+09:00」のようなフォーマット
└ address 開催場所
└ place 開催会場

APIの利用について

  • 節度を守ってご利用ください
  • 事前、事後ともに報告は不要です

他のAZusaar!! APIについて

http://sue445.hatenablog.com/category/API