オーダー REST API v2 (レガシー)

注文の作成 (レガシ)

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

大事な

このREST APIの新しいバージョン(v2.1)が利用可能です。このREST APIを初めて使用する場合は、新しいバージョンを使用してください。または、すでに古いバージョンを使用している場合は、v2とv2.1の違いについて読んでアップグレードできるようにしてください。

POST /v2/orders

注文を作成します。

少なくとも、要求本文で次の必須属性を指定する必要があります。

属性	種類	形容	例
pointOfSale	糸	注文に使用された販売時点情報。	"spinflight.com", "spinair.com"
currencyCode	文字列 (大文字のISO 4217)	ゲストが購入を完了するために使用した通貨。これを組織の既定の通貨に設定します。	"EUR", "NZD","USD"
price	数値 (通貨)	注文に対して支払われた金額。	50, 30.6
orderedAt	文字列 (ISO 8601)	注文が行われた日時。	"2025-01-01T16:17:16.000Z"
referenceId	糸	注文を参照するために組織によって生成される一意のID。フライトの注文の場合、これは多くの場合PNRです。	"B94TXY-1"

応答では、refに注文参照が含まれています。

curl -X POST <baseURL>/v2/orders' \
-u '<username>:<password>' \
-H 'Accept: application/json' \
--data-raw '
{
    "pointOfSale": "spinair.com/france",
    "channel": "WEB",
    "currencyCode": "EUR",
    "price": 12,
    "orderedAt": "2025-12-19T12:07:18.149Z",
    "referenceId": "B94TXY-1",
    "paymentType": "Card",
    "cardType": "Visa",
    "status": "PURCHASED"
}'

{
    "href": "<baseURL>/v2/orders/15d0417e-75a8-4340-9052-51b9ca36aab0",
    "ref": "15d0417e-75a8-4340-9052-51b9ca36aab0",
    "createdAt": "2025-12-19T12:19:01.268Z",
    "modifiedAt": "2025-12-19T12:19:01.268Z",
    "orderedAt": "2025-12-19T12:07:18.149Z",
    "currencyCode": "EUR",
    "price": 12,
    "referenceId": "B94TXY-1",
    "paymentType": "Card",
    "cardType": "Visa",
    "pointOfSale": "spinair.com/france",
    "channel": "WEB",
    "status": "PURCHASED",
    "contacts": {
        "items": [...]
    },
    "consumers": {
        "items": [...]
    },
    "orderItems": {
        "items": [...]
    }
}

この記事を改善するための提案がある場合は、お知らせください!