BOSHU
募集(BOSHU)に応募する側の API。公開中の募集を見て、応募・下書きの保存・取り下げをする。ログインせずにメールを確かめて応募する入口、外のサイトに埋め込んだフォームから応募する入口、選考の次の段へ提出する入口もある。
この分類のあらまし
- 誰が呼べるか
応募はログインした本人が呼ぶ。ログインなしの応募はメールに届く確認コードで、埋め込みのフォームは募集ごとの許可(トークン)で呼ぶ。
ログイン 19 件・認証なし 6 件・トークン 4 件
- 件数と印
この分類の API は 29 件・ポーリング 1 件・レート制限 16 件
画面が一定の間隔で呼び直す前提の API(ポーリング)。
短い時間に呼びすぎると断られる API(レート制限)。断られたら Retry-After の秒数を待って呼び直す。
- 契約での分類の説明
募集(BOSHU。スタッフ・登壇・ピッチ・その他)
よく使う順番
上から順に呼ぶことが多い組み合わせ。行を押すと、その API の詳細が右に開く(スマホは下から)。
すべての API29 件
この分類の API をすべて並べている。行を押すと、頁を移らずにその API の詳細が右に開き、送るもの・返るもの・呼び出しの見本が読める。閉じると一覧の同じ位置に戻る。
行の左の札は HTTP のメソッド。GET は情報の取得、POST は作成や操作の実行、PUT と PATCH は更新、DELETE は削除を表す。
- 本人の募集連絡先の確認状態と未読メール設定を読むGET取得
/api/boshu/contactログイン - 本人の4S資格を照合して募集連絡先の確認メールを予約するPOST作成・操作
/api/boshu/contactログイン・レート制限 - 本人と4S資格に結び付いた確認コードで募集連絡先を確定するPOST作成・操作
/api/boshu/contact/verifyログイン・レート制限 - 本人がBOSHUチャットの未読メールを切り替えるPATCH一部を更新
/api/boshu/contactログイン - 本人が募集連絡先を解除し未送信メールを停止するDELETE削除
/api/boshu/contactログイン - 同一originの本人popupで、この募集専用iframe認可を発行。cookieと現行規約への明示同意が必須。Bearer不可POST作成・操作
/api/boshu/calls/{id}/embedded/authorizeログイン(cookie)・レート制限 - 本人popupで認可済みの同一募集sessionだけをPKCE verifierで交換。cookie不要。新session/本人を作らずLP親へ返さないPOST作成・操作
/api/boshu/calls/{id}/embedded/exchange認証なし・レート制限 - 募集専用iframe認可で本人フォームを取得。cookie/Bearer不可、毎回本人/規約/公開状態を確認GET取得
/api/boshu/calls/{id}/embeddedトークン(募集の埋め込み) - 同一募集の本人応募/編集/取り下げ/共有確認/iframeログアウト。既存BOSHUサービスの資格・所有判定を共用POST作成・操作
/api/boshu/calls/{id}/embeddedトークン(募集の埋め込み) - 募集専用iframe内の本人画像添付。既存正規化/所有/制限を共用POST作成・操作
/api/boshu/calls/{id}/embedded/uploadsトークン(募集の埋め込み)・レート制限 - 募集専用iframeの本人添付画像。秘密をURLへ含めずproof headerで取得GET取得
/api/boshu/calls/{id}/embedded/uploads/{uploadId}トークン(募集の埋め込み) - 公開募集のLPフォーム情報(質問・入力仕様・正規応募URL)。常時匿名。公開metadata GET/OPTIONSのみAllow-Origin:*、資格付きCORSなし。応募/プロフィール/回答なし。iframeは許可LP上で公開閲覧、本人popup認証後に専用認可で同じiframe内入力/応募GET取得
/api/boshu/calls/{id}/form認証なし - 公開中で締切前の募集(受付中・受付前)と、自分の応募すべて(状態は結果を知らせた後だけ決定が出る)。?ownerKind=&ownerId= で持ち主の募集だけ(承認済み・承認不要と、機能 boshu が ON のイベントの募集だけが出る)GET取得
/api/boshuログイン・ポーリング - 1 つの募集(追加の質問・自分の応募)と、ワンクリック応募の下ごしらえ(本人のプロフィール・前回の入力・選べる作品)GET取得
/api/boshu/calls/{id}ログイン - 募集に応募する(審査中・保留なら直す・取り下げた応募は出し直す)。登壇・ピッチはプロフィールの必須回答が要る。invalid_answers の message は質問の id → 誤りの JSONPOST作成・操作
/api/boshu/calls/{id}/applyログイン - ログインなしの応募: 確かめるメールに 6 桁のコードを 1 通送る(同じメールへは 1 時間に 3 通まで)POST作成・操作
/api/boshu/calls/{id}/guest/code認証なし・レート制限 - ログインなしの応募: コードを確かめ、この募集にだけ使える応募の印(token)を返すPOST作成・操作
/api/boshu/calls/{id}/guest/verify認証なし・レート制限 - ログインなしで応募する(確かめたメール 1 つで 1 件。基本情報は応募の写しにだけ残す)POST作成・操作
/api/boshu/calls/{id}/guest/apply認証なし・レート制限 - 応募を取り下げる(結果を知らせる前だけ)POST作成・操作
/api/boshu/applications/{id}/withdrawログイン - 募集のキービジュアル・画像・PDFの回答を上げる(multipart/form-data: file。画像はWebPに書き直してメタデータを落とす。3MBを超えるPDFは more・parts で切れ端に分けて送る。返ったidを募集・回答に入れる)POST作成・操作
/api/boshu/uploadsログイン・レート制限 - 上げた画像(上げた本人と運営だけ。他人には 404)GET取得
/api/boshu/uploads/{id}ログイン - 公開募集の承認済みキービジュアル。ログインした管理者だけ下書きをプレビューできるGET取得
/api/boshu/calls/{id}/image認証なし(任意) - 本人がこの募集に書きかけた応募の下書きを読む(無ければ null)GET取得
/api/boshu/calls/{id}/draftログイン・レート制限 - 本人が応募の下書きを版を指定して保存する(応募はしない)PATCH一部を更新
/api/boshu/calls/{id}/draftログイン・レート制限 - 本人が応募の下書きを消すDELETE削除
/api/boshu/calls/{id}/draftログイン・レート制限 - 本人の書きかけの応募の下書きの一覧(受付中のイベントの募集だけ)GET取得
/api/me/boshu/draftsログイン・レート制限 - 応募者または権限のある担当者が応募の現在の選考を読むGET取得
/api/boshu/calls/{id}/selection/applications/{applicationId}ログイン・レート制限 - 応募者が募集チャットへの参加だけを変えるPATCH一部を更新
/api/boshu/calls/{id}/selection/applications/{applicationId}ログイン・レート制限 - 応募者が次の段階の回答と資料を提出するPOST作成・操作
/api/boshu/calls/{id}/selection/applications/{applicationId}/submissionsログイン・レート制限