柏のイベント管理サービスの統計情報が取れるAPIへの要望をまとめる

[yasulab]

• 動的に取得する方法の検討
• 柏の自前のイベント管理システムがAPIを実装したらできそう🤔
• どんなAPIであると良いかは、ここで事前に要望を決めておくと良さそう?

cc @mjk0513
cf. #190

[kiriem]

1月から柏近辺の4Dojos（柏・柏の葉・南柏・柏沼南）のイベント管理システムは一元管理されるようになる予定です。
いまのところ、各Dojoの開催日・回数等をAPI叩けば返ってくるように設計しているので、かなり柔軟に対応できると思います👍

[yasulab]

@nalabjp ナラさんの方で「こういうAPIだと統計スクリプトや既存のDB設計とうまく合致しやすい」といった要望があれば、それをこちらでお伝えしておくと良いかなぁと考えています🤔💭 もしそういった要望などがあれば伺いたいのですが、いかがですかね?

[nalabjp]

• リクエストパラメータ
  • dojoごとのユニークなID
    • フォーマットはなんでも
  • datetimeで範囲指定の絞込
    • フォーマットはなにかに準拠していればなんでも
    • since,untilとかstart,endとか開始と終了を指定できる
    • equal grater than, equal less than
  • 取得できる結果件数の最大値
    • 極端に大きな数字じゃなければ固定数の返却でも問題ないので、その場合は無くてもよいです。
• レスポンス
  • json
  • 返却件数に制限がある場合、次ページが存在するかどうかを判断できるもの
    • 例えば最大25件しか返らない場合、総件数が100件あるっていうデータとか総件数は分からないけど次ページのurlがあるとか
  • 開催データの詳細
    • 開始時刻
    • 参加申し込み人数（参加人数の方が厳密ですが、他のイベントサイトAPIではそこまで取れないので厳密には計測していない）
    • 開催日毎の詳細ページへのリンク（存在しないなら不要）
    • 開催日ごとのユニークID（存在しないなら不要）

現状で叩いている各イベントサイトとの互換性から挙げると、
パッと思いつくのはこんなところでしょうか。
標準的なAPIの範疇かとは思いますが、API側の想定を考慮せずにざっと挙げただけですので、
もう少しすり合わせさせてもらえると嬉しいです😌

[kiriem]

承知しました！実装までもう少し時間かかってしまいますが、こちらの仕様で行こうと思います！
開催日ごとの詳細ページは無いのでそこだけはできないのですが、他は大丈夫かと🙋

[nalabjp]

ありがとうございます！
よろしくお願い致します😌