マーケットAPI
マーケットAPIを使用して、マーケットを作成、更新、またはクエリします。
市場APIを使用して、市場データを作成、更新、またはクエリします。これには、アクション(作成/更新/削除)を実行する特定のエンドポイントと、市場に関連するイベントが含まれます。
APIにアクセスするためのURLは次のとおりです。 https://<instance>.cso.coupahost.com/api/markets
詳細については、 「インテグレーションのベストプラクティス 」を参照してください。
アクション
動詞 | パス | アクション | 説明 |
---|---|---|---|
取得 | /api/markets |
インデックス | Getアクションを実行してすべてのマーケットを取得する |
投稿 | /api/markets |
作成 | 1つまたは複数の市場オブジェクトを作成します。 |
プット | /api/markets |
更新 | 1つ以上の市場を更新します。一括更新を実行できます。 |
削除 | /api/markets |
削除 | もう1つの市場を削除します。一括削除を実行できます。 |
取得 | /api/markets/:id |
表示 | マーケットデータを1つ表示します。 |
プット | /api/markets/:id |
更新 | IDを使用して一度に1つの市場を更新 |
削除 | /api/markets/:id |
削除 | 一度に1つの市場を削除します。 |
要素
これらは市場APIで使用できる要素です
フィールド名 | フィールドの説明 | 必須 | 一意ですか? | 許容値 | で | 出力 | タイプ |
---|---|---|---|---|---|---|---|
ID |
一意の自動増分、システム生成ID |
はい | 整数 | ||||
名前 | 市場の名前 | はい | はい | はい | 文字列 | ||
説明 | 市場の簡単な説明 | はい | はい | 文字列 |
例
この例では、markets APIについてクエリしました。URLにGETしました:
https://<instance>.cso.coupahost.com/api/markets
市場が返答を得る
{
"total": 10,
"markets": [
{
"id": "9219601763469521167",
"name": "!Bank of Montreal Savings Tracker Demo"
},
{
"id": "9219595277140974408",
"name": "!JIRA-Tickets"
},
{
"id": "9219593060488131385",
"name": "!Market 1",
"description": "Logistics and Transportation"
},
{
"id": "9220538753220565326",
"name": "Arj Market 1",
"description": "XPO logistics"
},
{
"id": "9220538753220565329",
"name": "Arj Market 2",
"description": "XPO Transportation"
},
{
"id": "9219592846040196615",
"name": "Common Information"
},
{
"id": "9219593864376360801",
"name": "Consulting"
},
{
"id": "9219601774059719348",
"name": "D - Nikisha's Demo Market"
},
{
"id": "9219601938334799391",
"name": "E-Integrations"
},
{
"id": "9219601936493380282",
"name": "E-Top Tips to Audit Events"
}
]
}
作成/更新/削除
以下は、Coupa APIを使用して市場でアクションを実行する方法について説明します。
作成
/api/markets
以下のペイロードは2つのマーケットを作成します。
Payload:
{
"markets": [
{
"name": "Arjun Market 1",
"description": "XPO logistics"
},
{
"name": "Arjun Market 2",
"description": "XPO Transportation"
}
]
}
Response: 201
{
"result": [
{
"type": "api.post.added",
"description": "2 objects created."
}
],
"added": 2,
"markets": [
{
"id": "9220538753220565326"
},
{
"id": "9220538753220565329"
}
]
}
更新
/api/markets
以下のペイロードは市場を更新します。
To update one or more market at a time:
Payload:
{
"markets": [
{
"name": "Arj Market 1",
"description": "XPO logistics updated"
},
{
"name": "Arj Market 2",
"description": "XPO Transportation updated"
}
]
}
Response: 200 OK
{
"result": [
{
"type": "api.put.updated",
"description": "2 objects updated."
}
],
"updated": 2
}
削除
/api/markets
以下のペイロードは、一度に複数の市場を削除することです。個別または一括で市場を削除すると、関連するイベントも削除されることに注意してください。
Payload:
{
"markets": [
{
"id": "9220538753220565326"
},
{
"name": "Arjun Market 2"
}
]
}
Response: 200 OK
{
"result": [
{
"type": "market.deleted.logMsg",
"description": "The market Arjun Market 1 was deleted."
}
],
"deleted": 1
}
更新は寛大な方法で行われます。たとえば、1つのリソースの更新に失敗した場合、他のリソースは正常に更新される可能性があります。上記のペイロードの削除を参照してください。ペイロードで削除されたマーケットは1つだけです。削除または更新には、ペイロードにIDが必要です。
成功したリクエストは返り HTTP 200 Response
ます。回答の本文には、作成された申請書が含まれます。失敗したリクエストは返 HTTP 400 Bad Request
される。応答の本文には、XMLとしてフォーマットされた検証エラーが含まれます。
このページに表示されている一部、または全ての内容は、機械翻訳によるものです。ご了承ください。