部門APIのコール例

最後の更新
PDFとして保存

このページは機械翻訳を使用して翻訳されています。

部署の異なるクエリオプション

次に、Departments APIを使用してクエリを実行し、必要な結果セットを取得する方法の例を示します。

このクエリは、name = Marketingの部署を提供します

https://<instance>.coupahost.com/api/departments?name=Marketing

このクエリは、Login = coupasupportで特定のユーザーによって更新された部署を提供します

https://<instance>.coupahost.com/api/departments?created_by[login]=coupasupport

このクエリは、2007年1月1日以降に作成されたすべての経費レポートを提供します。

https://<instance>.coupahost.com/api/departments?created_at[gt]=2007-01-01

単一の部署を取得

この例では、IDが1の単一の部門を照会しました。

URLにGETを行いました：

https://<instance>.coupahost.com/api/departments/1
あるいは
https://<instance>.coupahost.com/api/departments?id=1

<?xml version="1.0" encoding="UTF-8"?>
<department>
   <id type="integer">1</id>
   <created-at type="datetime">2008-10-27T13:00:48-07:00</created-at>
   <updated-at type="datetime">2014-03-28T08:53:19-07:00</updated-at>
   <name>Marketing</name>
   <active type="boolean">true</active>
   <created-by>
      <id type="integer">1</id>
      <login>coupasupport</login>
      <email>upgrade@coupa.com</email>
      <employee-number nil="true" />
      <firstname>Coupa</firstname>
      <lastname>Support</lastname>
      <salesforce-id nil="true" />
      <mycustom-userfield />
   </created-by>
   <updated-by>
      <id type="integer">69</id>
      <login>coupasupport+rohitdemo@coupa.com</login>
      <email>coupasupport+rohitdemo@coupa.com</email>
      <employee-number nil="true" />
      <firstname>Integration</firstname>
      <lastname>User</lastname>
      <salesforce-id nil="true" />
      <mycustom-userfield />
   </updated-by>
</department>

部署作成

この例では、部署を作成しています。参照オブジェクトにCoupaシステムIDを使用していません。

次のURLに投稿しました：https://<instance url>/api/departments/.

<?xml version="1.0" encoding="UTF-8"?>
<department>
   <name>Marketing</name>
   <active>false</active>
</department>

部署の更新

これらの例では、単一の部門レコードを更新しています。

私たちは、URLにPUTをしました：https://instance.coupahost.com/api/departments/<id>

たとえば、ID 195の既存の部署を無効化するには

<?xml version="1.0" encoding="UTF-8"?>
<department>
   <id>195</id>
   <active>false</active>
</department>

たとえば、IDが195の既存の部署の名前を更新するには

<?xml version="1.0" encoding="UTF-8"?>
<department>
   <id>195</id>
   <name>new name</name>
</department>