BUDDYZ API リファレンス

イベントサーチAPI

検索クエリの条件に応じたイベント一覧を取得できます。

リクエストURL
http://buddyz.life/api/v1/event/
検索クエリ
パラメータ 項目名 説明
event_id イベントID 整数 イベント毎に割り当てられた番号で検索します。複数指定可能です*1 URLが http://buddyz.life/event/364/ のイベントの場合、イベントIDは 364 になります。
keyword キーワード (AND) 文字列(UTF-8) イベントのタイトル、キャッチ、概要、住所をAND条件部分一致で検索します。複数指定可能です*1
keyword_or キーワード (OR) 文字列(UTF-8) イベントのタイトル、キャッチ、概要、住所をOR条件部分一致で検索します。複数指定可能です*1
ym イベント開催年月 整数 指定した年月に開催されているイベントを検索します。複数指定可能です*1 yyyymm
(例) 201204
ymd イベント開催年月日 整数 指定した年月日に開催されているイベントを検索します。複数指定可能です*1 yyyymmdd
(例) 20120406
nickname 参加者のニックネーム 文字列(UTF-8) 指定したニックネームのユーザが参加しているイベントを検索します。複数指定可能です*1
owner_nickname 管理者のニックネーム 文字列(UTF-8) 指定したニックネームのユーザが管理しているイベントを検索します。複数指定可能です*1
series_id カテゴリID 整数 カテゴリ 毎に割り当てられた番号で、ひもづいたイベントを検索します。複数指定可能です*1 URLが http://buddyz.life/series/1/ のカテゴリの場合、カテゴリIDは 1 になります。
start 検索の開始位置 整数 検索結果の何件目から出力するかを指定します。 (初期値: 1)
order 検索結果の表示順 整数 検索結果の表示順を、更新日時順、開催日時順、新着順で指定します。 1: 更新日時順
2: 開催日時順
3: 新着順
(初期値: 1)
count 取得件数 整数 検索結果の最大出力データ数を指定します。 初期値: 10、最小値:1、最大値:100
format レスポンス形式 文字列(UTF-8) レスポンスの形式を指定します。 jsonに固定です。
パラメータを複数指定する場合は、 name=value1&name=value2&... または name=value1,value2... のように指定できます。
サンプル
marketingを含むイベントを検索
http://buddyz.life/api/v1/event/?keyword=marketing
レスポンスフィールド
フィールド 説明
results_returned 整数 含まれる検索結果の件数 1
results_available 整数 検索結果の総件数 191
results_start 整数 検索の開始位置 1
events 配列(複数要素) 検索結果のイベントリスト
event_id 整数 イベントID 364
title 文字列(UTF-8) タイトル Webマーケティング勉強会#1
catch 文字列(UTF-8) キャッチ ホールハートが主催する勉強会
description 文字列(UTF-8) 概要(HTML形式) 今回はWeb広告について、討論します。
event_url 文字列(UTF-8) buddyz.life 上のURL http://buddyz.life/event/364/
started_at 文字列(UTF-8) イベント開催日時 (ISO-8601形式) 2012-04-17T18:30:00+09:00
ended_at 文字列(UTF-8) イベント終了日時 (ISO-8601形式) 2012-04-17T20:30:00+09:00
limit 整数 定員 80
event_type 文字列(UTF-8) イベント参加タイプ participation: BUDDYZで参加受付あり
advertisement: 告知のみ
series オブジェクト カテゴリ
id 整数 カテゴリID 1
title 文字列(UTF-8) カテゴリタイトル 勉強会
url 文字列(UTF-8) カテゴリのbuddyz.life 上のURL http://buddyz.life/series/1/
address 文字列(UTF-8) 開催場所 東京都渋谷区神宮前6丁目27−8
place 文字列(UTF-8) 開催会場 ホールハートオフィス
lat 浮動小数点数 開催会場の緯度 35.680236100000
lon 浮動小数点数 開催会場の経度 139.701308500000
owner_id 整数 管理者のID 8
owner_nickname 文字列(UTF-8) 管理者のニックネーム BUDDYZ
owner_display_name 文字列(UTF-8) 管理者の表示名 小野進一
accepted 整数 参加者数 80
waiting 整数 補欠者数 15
updated_at 文字列(UTF-8) 更新日時 (ISO-8601形式) 2012-03-20T12:07:32+09:00

BUDDYZ ロゴの利用について

APIを利用して開発したサービス等にお使いください。リサイズ以外の素材加工についてはお控えください。
ご不明な点は お問い合わせ ください。