登壇者の限定リンク
登壇者に送る限定リンクの API。登壇者本人がリンクを開いて、載るプロフィールと写真を確かめ、直したい文字や写真を提案として送る。ログインしたアカウントをその登壇者に結ぶこともできる。
この分類のあらまし
- 誰が呼べるか
リンクに入っているトークンが資格になるので、ログインは要らない。アカウントを結ぶ入口だけはログインが要る。
ログイン 1 件・認証なし 5 件
- 件数と印
この分類の API は 6 件・レート制限 6 件
短い時間に呼びすぎると断られる API(レート制限)。断られたら Retry-After の秒数を待って呼び直す。
- 契約での分類の説明
登壇者の限定リンク(トークンが資格。ログイン不要)
よく使う順番
上から順に呼ぶことが多い組み合わせ。行を押すと、その API の詳細が右に開く(スマホは下から)。
すべての API6 件
この分類の API をすべて並べている。行を押すと、頁を移らずにその API の詳細が右に開き、送るもの・返るもの・呼び出しの見本が読める。閉じると一覧の同じ位置に戻る。
行の左の札は HTTP のメソッド。GET は情報の取得、POST は作成や操作の実行、PUT と PATCH は更新、DELETE は削除を表す。
- 本人に見せる内容: 確定すると載るプロフィール・運営の提案・直せる欄と上限・出るコンテンツの題と時刻(ほかの情報は出さない)GET取得
/api/speaker-preview/{token}認証なし・レート制限 - 本人が文字と未採用の写真を一括で提案へ保存し、確定を頼む(photoReceiptは同じリンク・提案の10分以内の写真だけ)PUT更新
/api/speaker-preview/{token}/profile認証なし・レート制限 - 確定すると載る写真(その登壇者のものだけ)GET取得
/api/speaker-preview/{token}/photo認証なし・レート制限 - 本人が写真を上げる(multipart の file。サーバで向きを当てて WebP に書き直し、メタデータを落とす。4 MB maximum)POST作成・操作
/api/speaker-preview/{token}/photo認証なし・レート制限 - 本人が未採用の写真を準備する。提案は変更せず、同じリンク・提案専用の10分以内のreceiptを返す(multipart file、WebP変換、4 MB maximum)POST作成・操作
/api/speaker-preview/{token}/photo-draft認証なし・レート制限 - ログイン中のアカウントをその登壇者へ結ぶ(ブラウザのログイン + 限定リンク)POST作成・操作
/api/speaker-preview/{token}/claimログイン(cookie)・レート制限