---
title: "回収命令(レガシー)"
slug: "retrieve-orders--legacy-"
abstract: "Sitecore CDP Order REST APIを使って注文を取得する方法を説明しています。"
---
# 回収命令(レガシー)

> !重要[このREST APIの新しいバージョン(v2.1)が利用可能です](https://api-docs.sitecore.com/cdp/order-rest-api)。このREST APIが初めてなら、新しいバージョンを使いましょう。あるいは、すでに古いバージョンを使っているなら、[v2とv2.1の違いについて調](https://doc.sitecore.com/cdp/ja/developers/api/rest-apis/legacy-rest-apis/order-rest-api-v2--legacy-/differences-between-v2-and-v2-1-of-the-order-rest-apis.html "Differences between v2 and v2.1 of the Order REST APIs") べてアップグレードしてみてください。

以下のいずれかのリクエストをしてください:

-   GET /v2/orders?referenceId=<referenceId>
-   GET /v2/orders?guestRef=<guestRef>

命令リストを回収する。リクエストのURIには、注文のreferenceIdかguestRefのいずれかをクエリ文字列パラメータとして含める必要があります。

パラメータ名

種類

概要

例

referenceId

ストリング

あなたの組織が発行する唯一のIDで、その注文を参照します。フライトオーダーの場合は、多くの場合PNRです。

2d7de9df-45a2-45ea-872c-30e45139007d

guestRef

ストリング

ゲストレコードの参照。  
  
ゲストの紹介がわからない場合は、まず [ゲストを回収](https://doc.sitecore.com/cdp/ja/developers/api/rest-apis/legacy-rest-apis/order-rest-api-v2--legacy-/retrieve-guests--legacy-.html)しましょう。

f7aabbca-1c1b-4fc2-be72-3e16294a4f03

応答において、items.hrefにおいて順序参照は、最後のスラッシュの後に続く文字列です:

"href": "<baseURL>/v2/orders/<orderRef>"

例えば、特定の注文を参照して[取得や](https://doc.sitecore.com/cdp/ja/developers/api/rest-apis/legacy-rest-apis/order-rest-api-v2--legacy-/retrieve-an-order--legacy-.html "Retrieve an order (legacy)")[更新](https://doc.sitecore.com/cdp/ja/developers/api/rest-apis/legacy-rest-apis/order-rest-api-v2--legacy-/update-an-order--legacy-.html "Update an order (legacy)")を行うために、注文を参照します。

referenceIdを使って注文を取得する方法:

curl -X GET '<baseURL>/v2/orders?referenceId=2d7de9df-45a2-45ea-872c-30e45139007d' \\
-u '<username>:<password>' \\
-H 'Accept: application/json'

guestRefを使って注文を取得する方法:

curl -X GET '<baseURL>/v2/orders?guestRef=f7aabbca-1c1b-4fc2-be72-3e16294a4f03' \\
-u '<username>:<password>' \\
-H 'Accept: application/json'

{
 "href": "<baseURL>/v2/orders?offset=0&limit=10&guestRef=f7aabbca-1c1b-4fc2-be72-3e16294a4f03",
 "offset": 0,
 "limit": 10,
 "first": {
 "href": "<baseURL>/v2/orders?offset=0&limit=10&guestRef=f7aabbca-1c1b-4fc2-be72-3e16294a4f03"
 },
 "last": {
 "href": "<baseURL>/v2/orders?offset=0&limit=10&guestRef=f7aabbca-1c1b-4fc2-be72-3e16294a4f03"
 },
 "items": 
 {
 "href": "<baseURL>/v2/orders/d680c9be-4c07-4731-857e-9602034b15f2"
 },
 {
 "href": "<baseURL>/v2/orders/9932bee2-25c2-4653-9ad3-8865865036d9"
 },­­­
 {
 "href": "<baseURL>/v2/orders/4b8eeee6-37f1-41ad-92fb-79e802db29a7"
 }
 
}