ゲスト作成(レガシー)

!重要このREST APIの新しいバージョン(v2.1)が利用可能です。このREST APIが初めてなら、新しいバージョンを使いましょう。あるいは、すでに古いバージョンを使っているなら、v2とv2.1の違いについて読 んでアップグレードしましょう。

POST /v2/guests

ゲストを作る。

!警告REST APIはゲスト作成時にゲストが既に存在しているかどうかを検証しません。重複ゲストの作成を避けるために、まずはゲストのメールアドレスやその他の識別情報を使って 取得 してください。

最低限、リクエスト文に以下の必要な属性を記載する必要があります:

属性

種類

概要

例

guestType

文字列エナム

獲得されたアイデンティティのレベル。

以下のいずれかでなければなりません:

• "visitor"
• "customer"
• "traveller"

レスポンスでは、refキーにゲスト参照が含まれています。

個人識別情報(PII)を使ってゲストを作成する:

curl -X POST '/v2/guests' \ -u ':' \ -H 'Accept: application/json' \ --data-raw ' { "guestType": "customer", "title": "Ms", "firstName": "Jane", "lastName": "Doe", "gender": "female", "dateOfBirth": "1976-10-28T00:`00

201 Created個人識別情報(PII)に関する回答:

{ "href":"/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03", "ref":"f7aabbca-1c1b-4fc2-be72-3e16294a4f03", "createdAt":"2026-03-07T16:`15

identifiersを使ってゲストを作成します:

curl -X POST '/v2/guests' \ -u ':' \ -H 'Accept: application/json' \ --data-raw ' { "guestType":"customer", "identifiers": { "provider":"BXLP", "id":"123456", "expiryDate":"2028-08-23T16:`17

}'

201 Createdidentifiersの回答:

{ "href":"/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03", "ref":"f7aabbca-1c1b-4fc2-be72-3e16294a4f03", "createdAt":"2026-03-07T16:`15

}

curl -X POST '/v2/guests' \ -u ':' \ -H 'Accept: application/json' \ --data-raw ' { "guestType": "customer", "title": "Ms", "firstName": "Jane", "lastName": "Doe", "gender": "female", "dateOfBirth": "1976-10-28T00:`00

}'

{ "href":"/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03", "ref":"f7aabbca-1c1b-4fc2-be72-3e16294a4f03", "createdAt":"2026-03-07T16:`15

}