コンシューマー REST API v2 (レガシ) を注文する

注文コンシューマーの作成 (レガシ)

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

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

大事な

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

POST /v2/orders/{:placeholder-token:}<orderRef>{/:placeholder-token:}/consumers

注文にコンシューマを作成します。

属性	種類	形容	例
{:placeholder-token:}orderRef{/:placeholder-token:}	糸	注文の参照。注文参照がわからない場合は、まず注文を取得します。	d680c9be-4c07-4731-857e-9602034b15f2

属性

種類

形容

例

{:placeholder-token:}orderRef{/:placeholder-token:}

糸

注文の参照。

注文参照がわからない場合は、まず注文を取得します。

d680c9be-4c07-4731-857e-9602034b15f2

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

属性	種類	形容	例
firstName	string (タイトルケースを推奨)	注文コンシューマの名。	"John"
lastName	string (タイトルケースを推奨)	注文コンシューマの姓。	"Doe"

レスポンスでは、refに注文コンシューマ参照が含まれています。

curl -X POST <baseURL>/v2/orders/d680c9be-4c07-4731-857e-9602034b15f2/consumers' \
-u '<username>:<password>' \
-H 'Accept: application/json' \
--data-raw '{
    "title": "Mr",
    "firstName": "John",
    "lastName": "Doe",
    "gender": "male",
    "guest": {
       "href": "<baseURL>/v2/guests/567A697E-4E79-4F2C-96D1-A7249A44744F"
    },
    "orderItems": {
       "items" : [{
            "href": "<baseURL>/v2/orderItems/FECBB7ED-6DFE-4E8C-85A9-B894B17EF4F3"
         }]
    }
}'

{
    "href": "<baseURL>/v2/orderConsumers/C439E8B9-53F3-48BB-BD98-EE3657416FBE",
    "ref": "C439E8B9-53F3-48BB-BD98-EE3657416FBE",
    "createdAt": "2025-08-15T16:00:55.554Z",
    "modifiedAt": "2025-08-21T16:00:51.882Z",
    "title": "Mr",
    "firstName": "John",
    "lastName": "Doe",
    "gender": "male",
    "guest": {
       "href": "<baseURL>/v2/guests/567A697E-4E79-4F2C-96D1-A7249A44744F"
    },
    "orderItems": {
       "items" : [{
             "href": "<baseURL>/v2/orderItems/FECBB7ED-6DFE-4E8C-85A9-B894B17EF4F3"
        }]
   },
    "order": {
       "href": "<baseURL>/v2/orders/056621C2-C955-492D-B7EE-C77C6BDDFDEE"
    }
}

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