今会えます
「今会えます」と注目の人の API。今会える人の一覧を読み、自分の「今会えます」を出す・取り消す。WANTED の上の帯に出る注目の人もここで読む。
この分類のあらまし
- 誰が呼べるか
ログインした参加者。
ログイン 4 件
- 件数と印
この分類の API は 4 件・ポーリング 2 件・レート制限 2 件
画面が一定の間隔で呼び直す前提の API(ポーリング)。
短い時間に呼びすぎると断られる API(レート制限)。断られたら Retry-After の秒数を待って呼び直す。
- 契約での分類の説明
今会えます・注目
よく使う順番
上から順に呼ぶことが多い組み合わせ。行を押すと、その API の詳細が右に開く(スマホは下から)。
すべての API4 件
この分類の API をすべて並べている。行を押すと、頁を移らずにその API の詳細が右に開き、送るもの・返るもの・呼び出しの見本が読める。閉じると一覧の同じ位置に戻る。
行の左の札は HTTP のメソッド。GET は情報の取得、POST は作成や操作の実行、PUT と PATCH は更新、DELETE は削除を表す。
- 今会える人(新しく出した順・場所とひとこと・残り分)と自分の「今会えます」。scope=mine は自分だけ。rev は分の区切りを含む(期限切れでも進む)。ETag / 304GET取得
/api/availabilityログイン・ポーリング - 「今会えます」を出す(出し直し = 上書き)。長さは 15 分の固定で、イベント終了を越えない(durationMin は互換のため受け取るが無視する)。pin は現在の会場図の場所(任意)PUT更新
/api/availabilityログイン・レート制限 - 「今会えます」を取り消すDELETE削除
/api/availabilityログイン・レート制限 - 注目の人(WANTED の上の帯)。枠は now(今会えます)→ hot(直近 1 時間に「会いたい」を受けた人数)→ featured(承認済み WANTED)。1 人 1 枠。ETag / 304GET取得
/api/featuredログイン・ポーリング