メインコンテンツまでスキップ

ゲスト登録

新規ゲストの登録を行います。

基本仕様​

  • エンドポイント : /guests
  • メソッド : POST

リクエストヘッダー​

APIキーなどの共通の設定は「Cracker API概要」を参照してください。

パスパラメータ​

なし

クエリパラメータ​

なし

リクエストボディ​

パラメータ名タイプ必須説明
guests配列必須来場者の続柄と名前を指定します。
guest_type文字列必須family/other
st_name文字列guest_typeがfamilyの場合必須生徒名
st_belong文字列guest_typeがfamilyの場合必須生徒所属
st_grade文字列guest_typeがfamilyの場合必須生徒学年, n年表記
st_class文字列guest_typeがfamilyの場合必須生徒クラス, n組表記(クラスなしの場合はなし)
state文字列必須ゲストの入退場状況を指定します。
mail文字列必須ゲストのメールアドレス指定します。
parking数値必須駐車券の必要有無 (1:必要, 0:不要)

guest_typeがotherの場合、生徒関係の情報は必要ありません。

リクエストボディサンプル

{
    "guests": [
        [
            "佐藤恵",
            "母"
        ],
        [
            "佐藤健一",
            "兄"
        ]
    ],
    "guest_type":"family",
    "st_name":"佐藤花子",
    "st_belong":"普通科",
    "st_grade":"3年",
    "st_class":"1組",
    "state": "not_entered",
    "mail": "satou@example.com",
    "parking": 1
}

レスポンスボディ​

パラメータ名タイプ説明
group_id文字列ゲストID
guests配列来場者の続柄と名前
guest_type文字列family/other
st_name文字列生徒名
st_belong文字列生徒所属
st_grade文字列生徒学年, n年表記
st_class文字列生徒クラス, n組表記(クラスなしの場合はなし)
state文字列ゲストの入退場状況
mail文字列ゲストのメールアドレス
parking数値駐車券の必要有無 (1:必要, 0:不要)
timestampタイムスタンプ登録時刻

guest_typeがotherの場合、生徒情報は空白でレスポンスされます。

レスポンスボディサンプル

{
  "group_id": "99b0c89c-b00c-48cb-9831-04cf536644bd",
  "guests": [
    [
      "佐藤恵",
      "母"
    ],
    [
      "佐藤健一",
      "兄"
    ]
  ],
  "guest_type": "family",
  "st_name": "佐藤花子",
  "st_belong": "普通科",
  "st_grade": "3年",
  "st_class": "1組",
  "state": "entered",
  "mail": "satou@example.com",
  "parking": 1,
  "timestamp": "2024-05-04 14:39:13"
}