• 最終編集日時: 03 February 2022

APIの戻り形式

Coupaの浅いAPI形式を使用して、クエリ中に取得するデータの量を減らします。

メモ

Coupaはより高度な機能を提供するようになりました APIフィルター 特定の出力を定義できます。浅い形式の代わりに、これらのフィルターを使用することをお勧めします。これは将来のリリースで廃止される予定です。

概要

CoupaのAPIは、デフォルトで多くのデータを返します(例:関連するオブジェクトの完全なオブジェクト)。APIのリターンペイロードは非常に大きくなる可能性があるため、時間がかかります。これは、リソースの不必要な消費はもちろん、無関係なデータを必要としないお客様にとって問題となる可能性があります。

Coupaには簡単に処理できるように返品形式があります return_object=shallow オブジェクトのスキーマ全体およびすべての関連付けの代わりに、限定されたJSONまたはXML応答を返します。オプションでreturn_objectを指定するという概念は新しいものではなく、新しいのは「浅い」形式の概念だけです。return_objectが指定されていない場合は、完全な戻り値が返されます。

仕組み

オプションのクエリパラメーター return_object では、次の3つの値がサポートされるようになりました。

  • none :何も返されません。これはPUTとPOSTに対してのみサポートされます(GETのようなクエリでは意味がありません)。
  • limited : IDのみが返されます。これは、すべてのコマンドでサポートされています。
  • shallow :このパラメーターは、呼び出されているオブジェクトのすべての属性/フィールドと、1つの深い関連付けのIDとナチュラルキーのみを返します。

パラメーター return_object=shallow は次の場合にサポートされます。

  • POSTコマンド
  • PUTコマンド
  • GETコマンド

fields クエリ演算子を使用すると、レスポンスボディに必要なフィールドを渡すことができます。の形式 fields 値はJSONです。以下の例を参照してください。

?fields=["id","invoice_number",{"invoice_lines":["id","line_num"]}]

オブジェクトを返す

を使用して、 return_object パラメーターを使用して、基本的な作成、更新、またはクエリの呼び出しで応答の本文の形式を制御します。

作成時および更新時にサポートされるreturn_object値は、none、limited、およびshallowです。

クエリ呼び出し時にサポートされる値は、limitedとshallowです。

例:クエリの制限応答

Query:  https://example.coupahost.com/api/expense_reports?return_object=limited
Response Code:  200
Response Body:
{“id”:1}

例:作成時に応答がない

POST:  https://example.coupahost.com/api/ex...rn_object=none
Request Body:
{
 "id":2,
 "currency":{
   "code":"USD"
 },
 "expense-lines":[
   {
     "description":"Airfare to Reno",
     "merchant":"American Airlines",
     "reason":"",
     "amount":"255.0",
     "expense-date":"2010-02-05T00:00:00-08:00",
     "start-date":"2010-02-05T00:00:00-08:00",
     "expense-category":{
       "name":"Airfare",
     }
   },
 ],
}
Response Code:  200
Response Body:

例:作成時の浅い応答

Query:  https://example.coupahost.com/api/ex...object=shallow
Response Code:  200
Response Body:
{
 "id":158,
 "created-at":"2010-09-22T20:42:57-07:00",
 "updated-at":"2014-04-24T14:56:49-07:00",
 "title":"",
 "status":"pending_approval",
 "submitted-at":"2014-04-24T14:56:49-07:00",
 "auditor-note":null,
 "reject-reason":null,
 "paid":false,
 "total":"567.07",
 "audit-score":26,
 "exported":false,
 "last-exported-at":null,
 "external-src-ref":null,
 "external-src-name":null,
 "currency":{
   "id":1,
   "code":"USD"
 },
 "expensed-by":{
   "id":20,
   "login":"user_login",
   "email":"user_login@coupa.com"
 },
 "created-by":{
   "id":20,
   "login":"user_login",
   "email":"user_login@coupa.com"
 },
 "updated-by":{
   "id":20,
   "login":"user_login",
   "email":"user_login@coupa.com"
 },
 "expense-lines":[
   {
     "id":546,
     "external-src-ref":null
   },
   {
     "id":547,
     "external-src-ref":null
   },
   {
     "id":548,
     "external-src-ref":null
   },
   {
     "id":549,
     "external-src-ref":null
   }
 ],
 "comments":[ ]
}

このページに表示されている一部、または全ての内容は、機械翻訳によるものです。ご了承ください。

関連アイテム


Coupa Core API

RESTful APIは、Coupaプラットフォームでデータの読み取り、編集、統合を行うための堅牢なアクセスを提供します。

リソース

オブジェクトのタイプごとにAPIエンドポイントを整理しました。参照データ、トランザクションデータ、および共有リソース。

参照データリソース

リファレンスデータは、ユーザー、サプライヤー、アカウントなど、Coupaのコアコンポーネントを設定するために使用されます。

取引リソース

Coupaを使用すると、依頼書、発注書、請求書などのトランザクションデータが作成されます。