airtunk ホテルバレー API (1.0.0)

Download OpenAPI specification:

Airtunk hotel valley service API

laravel middle ware : トークン検証・自分情報追加

AuthorizationヘッダーでBearerトークンを送信する
(axios.tsのインターセプターでヘッダーに付与する形になっているので、開発者が意識することではない)

全てのapi呼び出しで、アクセストークン検証を実施しますが、有効な場合、コンテキストに自分情報を追加します
jwtトークンを検証するミドルウェア
(airtrunk-ibd/src/app/Http/Middleware/VerifyJwtToken.php)にて、 Bearerトークンを分解。

分解後、token.subを使用して、staff.subから、ホテルや配送スタッフの情報を検索し、コンテキストに追加する
※ コンテキストに追加するのは、各apiで、リクエストされたユーザーの情報を使いまわすためである）
※ また、ログ出力も考慮すると、自分情報をコンテキストに追加しておく対応が必要。

FYI. https://laravel.com/docs/12.x/context

認証

認証関連のエンドポイント

ログイン（Email/Password認証）

Cognito認証を実行します。MFAが必要な場合はsessionを返却し、 MFAが不要な場合はアクセストークンを直接返却します。

Request Body schema: application/json
required

email required	string <email> メールアドレス
password required	string >= 8 characters パスワード

Responses

Request samples

Payload

Content type

application/json

{"email": "user@example.com",
"password": "SecurePassword123!"
}

Response samples

200
400
429
500

Content type

application/json

Example

MFA不要の場合

{"status": "SUCCESS",
"accessToken": "eyJhbGciOiJSUzI1NiIs...",
"idToken": "eyJhbGciOiJSUzI1NiIs...",
"refreshToken": "eyJjdHkiOiJKV1QiLCJlb...",
"user": {"id": "12345",
"email": "user@example.com",
"name": "田中太郎"
}
}

MFA認証コード検証

Email で送信された認証コードを検証し、成功時はJWTトークン一式を返却します。

Request Body schema: application/json
required

session required	string ログインAPIから取得したセッション
challengeResponse required	string^[0-9]{6}$ Email で受信した認証コード

Responses

Request samples

Payload

Content type

application/json

{"session": "AYABeA...",
"challengeResponse": "123456"
}

Response samples

200
400
429
500

Content type

application/json

{"accessToken": "eyJhbGciOiJSUzI1NiIs...",
"idToken": "eyJhbGciOiJSUzI1NiIs...",
"refreshToken": "eyJjdHkiOiJKV1QiLCJlb...",
"user": {"id": "12345",
"email": "user@example.com",
"name": "田中太郎",
"mfaEnabled": true
}
}

ログアウト

Cognito Global Sign Outを実行し、JWTトークンを無効化します。アクセストークンをリクエストボディに含めてください。

Request Body schema: application/json
required

accessToken

required

string

アクセストークン（JWT）

Responses

Request samples

Payload

Content type

application/json

{"accessToken": "eyJhbGciOiJSUzI1NiIs..."
}

Response samples

200
400
500

Content type

application/json

{"message": "ログアウトしました"
}

トークンリフレッシュ

リフレッシュトークンを使用して新しいアクセストークンとIDトークンを取得します。

Request Body schema: application/json
required

refreshToken

required

string

リフレッシュトークン（JWT）

Responses

Request samples

Payload

Content type

application/json

{"refreshToken": "eyJjdHkiOiJKV1QiLCJlb..."
}

Response samples

200
400
500

Content type

application/json

{"accessToken": "eyJhbGciOiJSUzI1NiIs...",
"idToken": "eyJhbGciOiJSUzI1NiIs..."
}

ユーザー情報取得

処理概要

JWTトークンから認証済みユーザーの情報を取得します。
ユーザー情報取得処理では、フロントエンドでの表示制御のため、自分情報を返却する

処理詳細

ユーザー権限(role)によって、返却値が異なる
- at-admin, at-sc-admin, at-sc
  - hotel_ids, airport_reception_idはnull
  - at-admin, at-sc-adminは、管理画面等では全てのホテル、全ての空港が検索できることになる
    - ホテルの一覧だったり、空港の一覧は、全件取得することになる。
- at-airport
  - airport_reception_idを返す
- hotel-admin, hotel
  - hotel_idsに値が入る
    - hotelの場合、そのユーザーが属するホテル1件が配列で返す
    - hotel-adminの場合、そのユーザーが属するグループ全体のhotel_idを配列で返す

Authorizations:

bearerAuth

Responses

Response samples

200
401
500

Content type

application/json

Example

AT管理者の場合

{"user": {"uuid": "550e8400-e29b-41d4-a716-446655440001",
"first_name": "太郎",
"last_name": "田中",
"email": "admin@airtrunk.example.com",
"role": "at-admin",
"hotel_ids": null,
"airport_reception_id": null
}
}

サービス申し込み済みチェック

申込テーブルから渡されたemail,name,'hotel_id'と合致するデータを探す
データがあればtrueを無ければfalseを返す

Request Body schema: application/json
required

email required	string <email>
name required	string 利用者氏名
hotel_id required	string <uuid> 宿泊予定ホテルのid

Responses

Request samples

Payload

Content type

application/json

{"email": "aaa@gmail.com",
"name": "やまだ ひさし",
"hotel_id": 1
}

Response samples

200
404

Content type

application/json

{"result": true
}

申し込み

申し込み関連のエンドポイント

申し込み一覧取得

指定されたクエリ条件に基づき、申込テーブルから申込データを取得します。リレーションを利用して、以下の関連情報も併せて取得します。

ゲストテーブル：宿泊者氏名、利用者名
ホテルテーブル：ホテル名

query Parameters

page	integer >= 1 Default: 1 ページ番号
per_page	integer [ 1 .. 100 ] Default: 20 1ページあたりの件数
reservation_holder_name	string 宿泊予約者名
user_name	string 利用者名
email	string メールアドレス
phone_number	string 電話番号
delivery_status	string 配送ステータス
hotel_name	string ホテル名
check_in_date	string <date> チェックイン日
luggage_qr_code	string 荷物qrコードの番号

Responses

Response samples

200

Content type

application/json

{"data": [{"application_id": "string",
"reservation_holder_name": "string",
"user_name": "string",
"email": "user@example.com",
"phone_number": "string",
"delivery_status": "applied",
"hotel_name": "string",
"check_in_date": "2019-08-24",
"traveler_qr_code": "string",
"luggage_qr_code": "string",
"luggage_reception_time": "2019-08-24T14:15:22Z"
}
],
"pagination": {"current_page": 1,
"total_pages": 0,
"total_count": 0,
"per_page": 1
}
}

申し込み登録

受け取った情報を下記のテーブルに保存

申込テーブル
ゲストテーブル

Request Body schema: application/json
required

reservation_holder_name required	string 宿泊旅行者名
user_name required	string 利用者名
relationship_with_guest required	string 宿泊者とのご関係
email required	string メールアドレス
phone_number required	string 電話番号
hotel_id required	string ホテルid
hotel_name required	string ホテル名
hotel_address required	string ホテル住所
check_in_date required	string <date> チェックイン日
check_out_date required	string <date> チェックアウト日
airport_id required	string 空港id
estimated_arrival_datetime required	string <date-time> 到着予定日時
flight_number	string or null 便名(任意)
counter_arrival_datetime required	string <date-time> 預入カウンターの到着予定日時
luggage_quantity required	integer 荷物の個数
coupon_code	string or null クーポンコード

Responses

Request samples

Payload

Content type

application/json

{"reservation_holder_name": "string",
"user_name": "string",
"relationship_with_guest": "string",
"email": "string",
"phone_number": "string",
"hotel_id": "string",
"hotel_name": "string",
"hotel_address": "string",
"check_in_date": "2019-08-24",
"check_out_date": "2019-08-24",
"airport_id": "string",
"estimated_arrival_datetime": "2019-08-24T14:15:22Z",
"flight_number": "string",
"counter_arrival_datetime": "2019-08-24T14:15:22Z",
"luggage_quantity": 0,
"coupon_code": "string"
}

Response samples

201

Content type

application/json

{"application_id": "string"
}

申し込み詳細取得

指定された申込IDに基づき、申込テーブルの対象データを取得
さらに関連する個人情報、ホテル情報、日本国内の空港情報、および預け入れカウンター情報をあわせて取得

path Parameters

application_id

required

string

Example: 550e8400-e29b-41d4-a716-446655440001

申し込みID

Responses

Response samples

200
404

Content type

application/json

{"customer_info": {"application_id": "550e8400-e29b-41d4-a716-446655440001",
"reservation_holder_name": "山田 太郎",
"user_name": "山田 太郎",
"relationship_with_guest": "本人",
"email": "yamada@example.com",
"phone_number": "090-1234-5678",
"country_name": "日本"
},
"hotel_info": {"hotel_id": "550e8400-e29b-41d4-a716-446655440000",
"hotel_name": "東急ホテル銀座",
"hotel_address": "東京都中央区銀座1-2-3",
"check_in_date": "2024-12-01",
"check_out_date": "2024-12-05"
},
"airport_info": {"airport_id": "550e8400-e29b-41d4-a716-446655440002",
"estimated_arrival_datetime": "2024-12-01T14:30:00+09:00",
"flight_number": "JL001"
},
"counter_info": {"counter_arrival_datetime": "2024-12-01T15:00:00+09:00"
},
"luggage_info": {"quantity": 2,
"luggage_qr_codes": ["LUG-2024-001-001",
"LUG-2024-001-002"
]
},
"arrangement_photo_info": {"arrangement_photos": ["https://airtrunk-ibd.s3.ap-northeast-1.amazonaws.com/arrangement-photos/550e8400-e29b-41d4-a716-446655440001/001.jpg",
"https://airtrunk-ibd.s3.ap-northeast-1.amazonaws.com/arrangement-photos/550e8400-e29b-41d4-a716-446655440001/002.jpg"
]
}
}

預かり同意サイン保存

荷物 QR コードを申込情報に紐づけ、預かり同意サインを保存し、預かり同意状態へ更新する処理を行います。

預かり同意サイン（signature）を S3 にアップロード
- アップロード後、サイン画像の取得用 URL を生成します。
申込テーブルの更新
- 取得したサイン画像 URL を預かりサインURLとして保存します。
- 預かりサインタイムスタンプに現在時刻を保存します。
荷物管理テーブルへの登録
- luggage_qr_codes に含まれる各 QR コードと applicationId を紐づけて荷物管理テーブルへ保存します。

path Parameters

application_id

required

string

申し込みID

Request Body schema: multipart/form-data
required

signature required	string <binary> 顧客のサイン(画像ファイル)
luggage_qr_codes	Array of strings

Responses

Response samples

404

Content type

application/json

{"message": "申し込みデータがありません"
}

受け渡しサイン保存

荷物 QR コードを申込情報に紐づけ、受け渡しサインを保存し、受け渡し完了状態へ更新する処理を行います。

受け渡しサイン（signature）を S3 にアップロード
- アップロード後、サイン画像の取得用 URL を生成します。
申込テーブルの更新
- 取得したサイン画像 URL を受け渡しサインURLとして保存します。
- 受け渡しサインタイムスタンプに現在時刻を保存します。
荷物管理テーブルへの登録
- luggage_qr_codes に含まれる各 QR コードと applicationId を紐づけて荷物管理テーブルへ保存します。

path Parameters

application_id

required

string

申し込みID

Request Body schema: multipart/form-data
required

signature

required

string <binary>

顧客のサイン(画像ファイル)

Responses

Response samples

404

Content type

application/json

{"message": "申し込みデータがありません"
}

追加荷物登録

預かり同意保存後に、後から追加した荷物を旅行者と紐づける

受け取った,applicationIdとluggage_qr_codeを荷物管理テーブルへ保存

path Parameters

application_id

required

string

申し込みID

Request Body schema: application/json
required

luggage_qr_code

required

string

荷物qr番号

Responses

Request samples

Payload

Content type

application/json

{"luggage_qr_code": "string"
}

Response samples

404

Content type

application/json

Example

申し込みが見つからない

{"message": "申し込みデータがありません"
}

荷物紐づけ解消

荷物と旅行者の紐づけを外す

指定された application_id と luggage_qr_code に基づき、以下の処理を行う。

荷物管理テーブルの検索

application_id と luggage_qr_code が一致する荷物管理データを荷物管理テーブルから検索する。

データの削除（紐づけ解除）

該当データが存在する場合、そのレコードを削除し、旅行者と荷物の紐づけを解除する。

path Parameters

application_id required	string 申し込みID
luggage_qr_code required	string 荷物QRコード

Request Body schema: application/json
required

luggage_qr_code

required

string

荷物qr番号

Responses

Request samples

Payload

Content type

application/json

{"luggage_qr_code": "string"
}

Response samples

404

Content type

application/json

Example

申し込みが見つからない

{"message": "申し込みデータがありません"
}

荷物ロケーション取得

指定された applicationId を基に、以下の手順で荷物のロケーションデータを取得する。

荷物管理テーブルからの検索
- applicationId をキーとして、荷物管理テーブルから該当する荷物管理データを取得する。
配送実績データの取得
- 取得した荷物管理データの id を基に、配送実績テーブルから関連する配送実績データを取得し、荷物のロケーション情報として返却する。

path Parameters

application_id

required

string

申し込みID

Responses

Response samples

200
404

Content type

application/json

{"location_info": {"departure_location_name": "string",
"departure_datetime": "2019-08-24T14:15:22Z",
"arrival_location_name": "string",
"arrival_datetime": "2019-08-24T14:15:22Z"
}
}

空港

空港関連のエンドポイント

空港受付一覧取得

空港受付テーブルから全データを取得する

query Parameters

page	integer >= 1 Default: 1 ページ番号
per_page	integer [ 1 .. 100 ] Default: 20 1ページあたりの件数

Responses

Response samples

200

Content type

application/json

{"data": [{"airport_id": "string",
"airport_name": "string"
}
],
"pagination": {"current_page": 1,
"total_pages": 0,
"total_count": 0,
"per_page": 1
}
}

空港締め処理作成

空港締め管理テーブルにデータを作成します。

counterId、staff_id、carbon::now()（現在日時）を空港締め管理テーブルへ保存。

path Parameters

counter_id

required

string

空港受付Id

Request Body schema: application/json
required

staff_id

required

string

スタッフ

Responses

Request samples

Payload

Content type

application/json

{"staff_id": "string"
}

Response samples

404

Content type

application/json

{"message": "空港データがありません"
}

空港締め処理削除

空港締め管理テーブルのデータを削除

counterIdを元に空港締め管理テーブルから該当するカウンターのデータを取得する
取得したデータ達の中から今日の締め処理データ探し出す
存在したら削除する

path Parameters

counter_id

required

string

空港受付Id

Responses

Response samples

404

Content type

application/json

{"message": "今日の締め処理が保存されていません"
}

空港締め処理確認

counterId を指定して、当日における空港の締め処理データが存在するかを確認。

path Parameters

counter_id

required

string

空港受付Id

Responses

Response samples

200
400
404

Content type

application/json

{"result": true
}

スタッフ

スタッフ関連のエンドポイント

担当車両取得

スキャンした車両QRコードをもとに、ログインしているスタッフの担当車両を取得する。

スキャンしたQRコード.車両m_IDを用いて、
- 行き先マスター.車両m_IDを引いてくる
  - 適用開始日・終了日を検査する
- 行き先Mマスターとロケーション系マスタを使用してレスポンスを生成する
  - ロケーション系マスタとは、
    - 空港受付
    - ホテルエリア
    - デポ
    - 積み替え
  - 空港受付Mから引っ張ってくる時は、"japanese_name"を行き先ロケーション名とすること

path Parameters

staff_id

required

string

スタッフID

query Parameters

vehicle_id

required

string

車両ID

Responses

Response samples

200
404

Content type

application/json

[{"vehicle": {"id": "string",
"logical_id": "string",
"types": "string",
"number": "string",
"management": "string",
"memo": "string"
},
"route": {"location_id": "string",
"location_name": "string",
"location_memo": "string"
}
}
]

配達車両

配達車両関連のエンドポイント

集配先ルート一覧

車両に紐づけられた目的地達を取得

path Parameters

vehicle_id

required

string

車両ID

Responses

Response samples

200
404

Content type

application/json

{"pickup_info": {"pickup_delivery_type": "string",
"location_id": "string",
"luggage_route_detail_id": "string",
"address": "string",
"pickup_quantity": 0
},
"delivery_info": {"location_id": "string",
"luggage_route_detail_id": "string",
"address": "string",
"delivery_quantity": 0,
"work_instruction": "string"
}
}

行き先

行き先関連のエンドポイント

ロケーション検証

登録されている行き先を取得

destinationIdに基づき行き先テーブルからデータを取得

typeに応じたidを取得する

airport_reception -> airport_reception_id
hotel -> hotel_id

検証

上記で取得したidとlocation_idが同じか検証する

path Parameters

destination_id

required

string

行き先ID

Request Body schema: application/json
required

location_id

required

string

スキャンしたロケーションのid

Responses

Request samples

Payload

Content type

application/json

{"location_id": "string"
}

Response samples

200
400
404

Content type

application/json

{"result": true,
"location_id": "string"
}

配達品

配達品関連のエンドポイント

配達荷物取得

指定された行き先 ID に関連する荷物データを取得する。

ホテルの場合

1. ホテルデータの取得

行き先 ID と一致するホテルデータを、ホテルテーブルから検索する。

2. 申込データの取得

取得したホテルデータの ID に紐づく申込データを、申込テーブルから取得する。

3. 荷物データの取得

見つかった申込データと紐づく荷物データを検索し、結果として返却する。

空港の場合

1. 空港データの取得

行き先 ID と一致する空港データを、空港テーブルから検索する。

2. 申込データの取得

取得した空港データの ID に紐づく申込データを、申込テーブルから取得する。

3. 荷物データの取得

見つかった申込データと紐づく荷物データを検索し、結果として返却する。

path Parameters

destination_id

required

string

行き先ID

Responses

Response samples

200
404

Content type

application/json

{"application_info": {"application_id": "string",
"reservation_holder_name": "string",
"user_name": "string",
"luggage_qr_code": "string"
}
}

ロケーション検証

荷物と配達先が一致してるか調べる

荷物管理テーブルからluggage_qr_codeと合致するデータを取得
荷物データに紐づいている申込データを取得
申込データのdelivery_hotel_idとlocation_idが一致しているか調べる

path Parameters

destination_id

required

string

行き先ID

Request Body schema: application/json
required

location_id required	string スキャンしたロケーションのid
luggage_qr_code required	string 荷物qr番号

Responses

Request samples

Payload

Content type

application/json

{"location_id": "string",
"luggage_qr_code": "string"
}

Response samples

200
400
404

Content type

application/json

{"result": true,
"location_id": "string"
}

ホテル置き配証拠アップロード

証拠写真のアップロードと紐づけ

photos に含まれる全ての画像が処理されるまで、以下の手順を繰り返す。

1. 証拠写真（photo）を S3 にアップロード

photo を S3 にアップロードする。
アップロード完了後、画像取得用の URL を受け取る。

2. 荷物置き配写真テーブルへの登録

取得した 証拠写真 URL を、 application_ids に含まれる各 id と紐づけて保存する。

配送実績への保存

luggage_qr_codesの中身の荷物QRId達,staff_id,hotel_id,location_typeを配送実績に保存する

path Parameters

destination_id

required

string

行き先ID

Request Body schema: multipart/form-data
required

staff_id required	string スタッフid
location_type required	string ロケーションタイプ
hotel_id required	string ホテルid
application_ids required	Array of strings
luggage_qr_codes required	Array of strings
photos required	Array of any

Responses

Response samples

404

Content type

application/json

{"message": "行き先データがありません"
}

ホテル配達完了

受取サインのアップロードと紐づけ

1. 受取サイン（photo）を S3 にアップロード

アップロード後、取得用 URL を受け取る。

2. ホテル引渡サインテーブルへの登録

取得した受取サイン URL と、application_ids の id達を紐づけて保存します。

配送実績に保存する

luggage_qr_codesの中身の荷物QRId達,staff_id,hotel_id,location_typeを配送実績に保存する

path Parameters

destination_id

required

string

行き先ID

Request Body schema: multipart/form-data
required

staff_id required	string スタッフid
location_type required	string ロケーションタイプ
hotel_id required	string ホテルid
application_ids required	Array of strings
luggage_qr_codes required	Array of strings
signature required	string <binary> サイン(画像ファイル)

Responses

Response samples

404

Content type

application/json

{"message": "行き先データがありません"
}

配達実績登録

luggage_qr_codesの中身の荷物QRId達,staff_id,location_type,location_idに関してはairtport_idとして配送実績テーブルに保存する

path Parameters

destination_id

required

string

行き先ID

Request Body schema: application/json
required

luggage_qr_codes required	Array of strings
staff_id required	string スタッフid
location_type required	string ロケーションタイプ
location_id	string スキャンしたロケーションのid

Responses

Request samples

Payload

Content type

application/json

{"luggage_qr_codes": ["string"
],
"staff_id": "string",
"location_type": "空港",
"location_id": "string"
}

Response samples

404

Content type

application/json

{"message": "行き先データがありません"
}

配達ステータス強制変更

配送ステータス強制変更API

path Parameters

destination_id

required

string

行き先ID

Request Body schema: application/json
required

delivery_status required	string 配送ステータス
application_ids required	Array of strings

Responses

Request samples

Payload

Content type

application/json

{"delivery_status": "string",
"application_ids": ["string"
]
}

Response samples

404

Content type

application/json

{"message": "行き先データがありません"
}

ホテル

ホテル関連のエンドポイント

ホテル認証コード一覧

hotelIdに該当するデータを認証コードテーブルからすべて引っ張ってくる

path Parameters

hotel_id

required

string

ホテルID

Responses

Response samples

200
404

Content type

application/json

{"codes": [{"hotel_id": "string",
"code": "string"
}
]
}

検品荷物情報取得

1. ホテルデータの取得

ホテルID と一致するホテルデータを、ホテルテーブルから検索する。

2. 申込データの取得

取得したホテルデータの ID に紐づく申込データを、申込テーブルから取得する。

3. 荷物データの取得

見つかった申込データと紐づく荷物データを検索し、結果として返却する。

path Parameters

hotel_id

required

string

ホテルID

Responses

Response samples

200
404

Content type

application/json

{"application_info": {"application_id": "string",
"reservation_holder_name": "string",
"user_name": "string"
},
"luggage_info": {"luggage_qr_code": "string"
}
}

検品完了

検品完了状態にする

path Parameters

hotel_id

required

string

ホテルID

Request Body schema: application/json
required

luggage_qr_codes

required

Array of strings

Responses

Request samples

Payload

Content type

application/json

{"luggage_qr_codes": ["string"
]
}

Response samples

404

Content type

application/json

{"message": "ホテルデータがありません"
}

ホテルグループに属するホテル一覧取得

指定されたグループIDに紐づくホテル情報を、ホテルテーブルから取得。
取得したホテルデータをエリア単位でグルーピングし、所定のソート順で並び替えたうえで、フロントエンドへ返却

path Parameters

group_id

required

string

グループID

Responses

Response samples

200

Content type

application/json

{"group": {"group_id": 11111,
"group_name": "東急",
"areas": [{"area_id": 1234,
"area_name": "渋谷",
"hotels": [{"id": "220e8400-e29b-41d4-a716-44665541234",
"logical_id": "220e8400-e29b-41d4-a716-44665541234",
"hotel_area_id": "220e8400-e29b-41d4-a716-44665541234",
"hotel_group_id": "220e8400-e29b-41d4-a716-44665541234",
"japanese_name": "東急ホテル渋谷",
"english_name": "Tokyu Plaza Sibuya",
"address": "東京都 渋谷区",
"latitude": 2222.22222,
"longitude": 2222.22222,
"memo": "搬入口はホテルの裏",
"delivery_priority": 2,
"operation_status": "contact_less",
"applicable_start_date": "2022-11-23",
"applicable_end_date": null,
"created_at": "2022-11-23",
"updated_at": "2022-11-23",
"deleted_at": null
}
]
}
]
}
}

ホテルグループ認証コード検証

※ クーポンと言っているが、割引などではなく認証のためのコードなので注意

データ取得

ホテルテーブルからhotel_idと合致するデータを取得
ホテルデータからホテルグループidをとりあえず
クーポンコードテーブルからホテルグループid,coupon_codeが合致するデータを取得する

検証

取得したクーポンコードデータについて、以下の条件で「今日の日時」が有効期間内かどうかを検証する。

適用開始日時 ≤ 今日の日時 < 適用終了日時

上記条件を満たす場合、認証は有効と判定する。

Request Body schema: application/json
required

hotel_id required	string ホテルid
coupon_code required	string クーポンコード

Responses

Request samples

Payload

Content type

application/json

{"hotel_id": "string",
"coupon_code": "string"
}

Response samples

200
400
404

Content type

application/json

{"result": true
}

マスタ

airtunk ホテルバレー API (1.0.0)

laravel middle ware : トークン検証・自分情報追加

認証

ログイン（Email/Password認証）

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

MFA認証コード検証

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

ログアウト

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

トークンリフレッシュ

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

ユーザー情報取得

処理概要

処理詳細

Authorizations:

Responses

Response samples

サービス申し込み済みチェック

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

申し込み

申し込み一覧取得

query Parameters

Responses

Response samples

申し込み登録

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

申し込み詳細取得

path Parameters

Responses

Response samples

預かり同意サイン保存

path Parameters

Request Body schema: multipart/form-datarequired

Responses

Response samples

受け渡しサイン保存

path Parameters

Request Body schema: multipart/form-datarequired

Responses

Response samples

追加荷物登録

path Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

荷物紐づけ解消

path Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

荷物ロケーション取得

path Parameters

Responses

Response samples

空港

空港受付一覧取得

query Parameters

Responses

Response samples

空港締め処理作成

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: multipart/form-data
required

Request Body schema: multipart/form-data
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: multipart/form-data
required

Request Body schema: multipart/form-data
required