本文へ移動
Bounty Developer

GET/api/events/{slug}

「イベント」の分類の、情報を読み出す API。ログインした本人として呼ぶ。

要約

イベントのページ（概要・日程・会場・説明・4S のタイムテーブル・受付中の募集・フォロー・参加 / 管理の印。管理者には機能の一覧）

呼び方と印

ログイン

URL に付ける値（パラメータ）

経路の中の波かっこの部分と、URL の ? の後ろに付ける値。「必須」の印があるものは省けない。

  • slugpath必須string

返るもの（応答）200 · application/json

成功したときに返る形。入れ子の欄は、その行を押すと開く・閉じる。「任意」の印がある欄は返らないことがある。

  • eventobject
    • idstring
    • slugstring
    • foursEventIdstring
    • titlestring
    • catchphrasestring | null
    • coverUrlstring | null
    • startsAtstring | null
    • endsAtstring | null
    • timezonestring
    • datesstring
    • venuestring | null
    • foursUrlstring | null
    • phase"upcoming" | "ongoing" | "past"
    • isPrimaryboolean
    • mode任意"small" | "large"
    • featuresobject
      • wantedboolean
      • boshuboolean
      • timetableboolean
      • checkinboolean
      • surveyboolean
      • qaboolean
      • meet_qrboolean
      • rankingboolean
      • venue_mapboolean
      • stampsboolean
      • groupsboolean
      • self_joinboolean
      • trioboolean
      • contentsboolean
      • exhibitionsboolean
      • wall_consultboolean
      • meet_limitsboolean
      • meet_tablesboolean
      • meet_followupboolean
      • meet_reciprocalboolean
      • ticket_modulesboolean
      • wanted_rotationboolean
    • participatingboolean
    • managingboolean
    • settingsRevision任意string/^[a-f0-9]{64}$/
    • descriptionstring | null
    • programobject | null
      • sessionsarray<object>
        • idstring
        • titlestring
        • startsAtstring
        • durationMininteger
        • stagestring | null
        • speakersarray<object>
          • namestring
          • titlestring | null
          • photoUrlstring | null
          • role"speaker" | "moderator"
    • openCallsarray<object>
      • thumbnailUrl任意string
      • hasKeyVisual任意boolean
      • idstring
      • kind"staff" | "talk" | "pitch" | "other"
      • kindLabelstring
      • titlestring
      • sessionIdstring | null
      • sessionTitlestring | null
      • whenstring | null
      • capacityinteger | null
      • remaininginteger | null
      • paidboolean
      • closesAtstring
      • appliedboolean
      • entryHref任意string/^\/(?:forms\/partners|boshu)\/[0-9a-f-]{36}$/
      • ownerobject
        • kindenum(5)"platform" "event" "guild" "venture" "person"
        • idstring | null
        • namestring
        • hrefstring | null
    • featureCatalogarray<object> | null
      • keyenum(22)"wanted" "boshu" "timetable" "checkin" "survey" "qa" "meet_qr" "ranking" "venue_map" "stamps" "groups" "self_join" …+10
      • labelstring
      • descriptionstring
      • enabledboolean
      • isDefaultboolean

失敗したとき（エラー）

失敗したときの状態コードと、その意味。本文の error の値で、プログラムが失敗の種類を見分けられる。

  • 400入力の誤り（error = invalid_input など）
  • 401未ログイン（unauthorized）/ Bearer が無効（invalid_token。WWW-Authenticate 付き）
  • 403権限が無い
  • event_not_found

呼び出しの見本

そのまま試せる呼び出しの例。curl と fetch をタブで切り替える。ID やトークンは自分の値に置き換える。

curl "https://bounty.spikes.4s.link/api/events/{slug}" \
  -H "Authorization: Bearer $BEARER_AUTH"
GET /api/events/{slug} | Bounty Developer