QR
QR とパスの API。自分の QR を出し、相手の QR を読み取って出会いを記録する。企業・ブースの QR や会場チェックインの QR の確認、印刷する参加パスと NFC カードへの書き込みの準備もここにある。
この分類のあらまし
- 誰が呼べるか
ログインした本人。NFC カードから公開プロフィールを引く入口だけは、同じサイトのブラウザからログインなしで呼べる。
ログイン 21 件・認証なし 1 件
- 件数と印
この分類の API は 22 件・ポーリング 2 件・レート制限 3 件
画面が一定の間隔で呼び直す前提の API(ポーリング)。
短い時間に呼びすぎると断られる API(レート制限)。断られたら Retry-After の秒数を待って呼び直す。
- 契約での分類の説明
QR
よく使う順番
上から順に呼ぶことが多い組み合わせ。行を押すと、その API の詳細が右に開く(スマホは下から)。
すべての API22 件
この分類の API をすべて並べている。行を押すと、頁を移らずにその API の詳細が右に開き、送るもの・返るもの・呼び出しの見本が読める。閉じると一覧の同じ位置に戻る。
行の左の札は HTTP のメソッド。GET は情報の取得、POST は作成や操作の実行、PUT と PATCH は更新、DELETE は削除を表す。
- 本人の有効パス候補と最終NFC書込み確認状態(準備中・参加資格不足を区別)GET取得
/api/passes/eventsログイン - 本人の対象イベントのパス内容と確認版GET取得
/api/passes/{eventId}ログイン - 本人のパス下書きと描画確認を保存(印刷・NFC・入場なし)POST作成・操作
/api/passes/{eventId}ログイン - 本人パスの印字PNGとレイヤーを描画(書込みなし)POST作成・操作
/api/passes/{eventId}/previewログイン - cookie本人だけが確認済みNFCパスの書込みを準備(他人ID・PAT不可)POST作成・操作
/api/passes/{eventId}/nfc/prepareログイン(cookie) - cookie本人の同tag読み戻しを検査して書込み完了記録(入場なし)POST作成・操作
/api/passes/{eventId}/nfc/completeログイン(cookie) - 物理上書き前に旧本人カード所有とoperation/tag/fingerprintを認可(資格期限切れ旧カードも所有確認)POST作成・操作
/api/passes/{eventId}/nfc/rewriteログイン(cookie) - 同源ブラウザが有効NFC資格から公開プロフィールIDのみ解決(匿名可・書込み/入場/交換なし・PAT不可)POST作成・操作
/api/passes/nfc/profile認証なし・レート制限 - cookie本人の現資格と実tag hashを読み取り照合(書込み・入場記録なし)POST作成・操作
/api/passes/nfc/resolveログイン(cookie) - 本人が所属する会社・団体の登録済み印字ロゴ(白黒PNG)GET取得
/api/passes/logosログイン - 自分の QR(4S One QR と、旧来の短命の署名付きペイロード)GET取得
/api/qr/meログイン・ポーリング - 指定時刻以降の自分宛てQR読取り通知GET取得
/api/qr/receivedログイン・ポーリング - 相手の QR(Bounty の署名付き QR か 4S One QR)を読み取ってミートを記録する。Bounty 外の人は external_contact に記録POST作成・操作
/api/qr/meetログイン・レート制限 - QR の入口で読んだ会場チェックイン QR の対象(セッション / 地点の名前・分類・場所・チェックイン済みか)。書き込まないGET取得
/api/checkin/previewログイン - QR を作り直す(古い QR は使えなくなる)POST作成・操作
/api/qr/rotateログイン - 選択イベントの本人QR。現在の参加資格と画面の本人・イベント・設定版を照合GET取得
/api/events/{slug}/qr/meログイン - 選択イベントの企業・ブースQR。現在の所属とパートナーを照合GET取得
/api/events/{slug}/qr/contextsログイン - 選択イベントを保持した企業・ブースの共有先確認GET取得
/api/events/{slug}/qr/contexts/previewログイン - 同イベントの現在の参加資格と本物のQRを照合して交換実績・由来を記録POST作成・操作
/api/events/{slug}/qr/meetログイン・レート制限 - 選択イベントから本人の個人QRを更新。個人QRの失効は全イベントで共通POST作成・操作
/api/events/{slug}/qr/rotateログイン - 自分の企業・ブースの QR(companyId / contentId を付けるとその QR の署名)GET取得
/api/qr/contextsログイン - 企業・ブースの QR を読んだときの共有先の確認GET取得
/api/qr/contexts/previewログイン