Skip to main content

はじめに

オペレーティング・システム(OS)におけるグラフィック・ユーザインターフェース(GUI)の登場はコンピューターを巻き込む環境を大きく変えました。 その変化の一つとして操作のしやすさが取り上げられます。GUIによってもはやコンピューターは専門家の道具から、誰でも使えるツールとして我々の生活に定着しています。 しかし、全てにおいて表と裏があるように必ずしも良い影響ばかりではありませんでした。 従来のコマンドライン・インターフェース(CLI)と比べて一般ユーザの利便性を大きく向上させたGUIは、利便性の代わりに視覚的な処理のためにコンピューターのパフォーマンスが低下したり、細かい制御がしにくい、習熟すると逆に操作が遅くなるなどの問題がありました。いわゆる使い慣れている専門家から見ると非効率的な要素が大きいです。 それ故、現存するOSは種を問わずGUIとCLIが共に揃っています。 専門ETLツールである弊社のXplentyは、ノーコード/ローコードツールとしてデータパイプラインの構築に対してGUI環境を提供しております。しかし、上記のOSの例と同じくデータパイプラインを構築と運用が慣れるとGUIによる操作は頻雑になります。 その時のためにXplentyではCLIベースでご利用できるRest APIを提供しています。今回の記事ではXplentyが提供しているRest APIの中で閲覧系について詳しく見てみましょう。

事前準備

制限事項

この記事は下記の前提で説明を行います。ご了承ください。
  1. データパイプライン(Xplentでは、パッケージ)は、作成済みである
  2. Crul、Postman、InsomniaなどのHTTP/HTTPSクライアントの使用経験がある
  3. Rest APIの操作に慣れている
  4. APIの詳細についてはgithub(英語)をご参照ください。

Xplenty Rest APIの基本情報

XplentyのRest APIは、Xplentyが提供しているHTTPS基盤のRESTful API群ですので、使い方も普段のRESTful APIの使用と変わりがありません。 この記事では、githubの内容を元にRest APIのハンズオンとして説明致します。
  • Rest APIのURL
    • https://api.xplenty.com/<account_id>/api/<reosurce_name>
      • <account_id>は、XplentyのSettings - Accounting Settings - Profileにて取得可能
intermediate-part09-jp image 1
  • <reosurce_name>についてはXplentyの主なリソースの紹介の部分をご参考ください。
  • 認証方式
    • HTTP Basicを使用しており、全てのXplenty Rest APIは認証が必須である。
    • ユーザ名は、XplentyのAPI KEYを指定し、パスワードはなし
      • curlでの指定 - -d <API_KEY>:
    • <API KEY>は、XplentyのSettings - Developer Settings - Access tokenにて取得可能
intermediate-part09-jp image 2
  • 但し、現時点でAPI KEYのお求めの場合は、Live Chatにてお問い合わせください!!
  • 呼び出しの回数制限
    • ユーザごとに1時間当たり5000回の呼び出し回数の制限(credit)が存在
    • 指定の呼び出し回数が超過した場合、429 Too Many Requestsを返却

Rest APIの呼び出しの見本

では、Xplentyの Rest APIの呼び出しの見本をそれぞれのHTTP/HTTPS・クライアントにて紹介します。 呼び出し見本の説明は、List Jobsを用いてHTTP/HTTPS・クライアント上の操作は行います。 また、Xplentyが提供している全てのAPIのリストは、このリンクをご参照ください。

GUIアプリによる呼び出し

有名なHTTP/HTTPS・クライアントであるPostmanやInsomniaを使って、XplentyのRest APIを呼び出してみましょう。この見本は、Postman上で指定のパッケージを指定のクラスタで実行します。
  1. Rest APIのURLをアドレスバーに設定
  2. 上記のURLに対して適切なメソッド(ここではGET)を選択
  3. 認証(Authentication)で方法をBasicに選択してから、usernameにはAPI_KEYを入れてpasswordは空白のままにしておく
intermediate-part09-jp image 3
  1. Headerに呼び出し時に必要なHeaderを該当APIのドキュメントを参照して適切に設定
intermediate-part09-jp image 4
  1. Sendボタンを押してレスポンスを確認
intermediate-part09-jp image 5

Curlコマンドによる呼び出し

コマンドラインによる操作に慣れている方の場合、curlを当たり前のように使っていると思います。curlの操作方法が知りたい方は下記の2つの資料をご参考頂ければ幸いです。 前のPostmanと同じ操作がcurlコマンドにて行います。 呼び出し時に必要な情報は下記のオプションを使って設定してください。
  1. -X -メソッドの指定(GETを指定)
  2. -u - Baisc認証の設定(<API_KYE>:)
  3. URL - ジョブリスト取得のREST APIのURL
  4. -H - Rest APIの呼び出し時に必要なヘッダー情報
  • Request (Curl Call) Syntax
  • Response Example

Xplentyリソースの閲覧

Xplentyには、データ転送作業に関わる幾つかの概念をリソースと呼んでいます。 作業に該当する適切なリソースを選んで操作を行います。 閲覧系のRest APIは、これらのリソースの存在有無、およびリソースの詳細情報を得るために必須のAPIです。Rest APIで閲覧系は、各々のリソースに対してGETメソッドによって呼び出されます。

Xplentyの主なリソースの紹介

Xplentyで使われる主なリソースは下記の通りです。

主なリソースの閲覧API

主なリソースを閲覧するために下記のAPIを使用します。各々のRest APIには指定可能なパラメータが存在しており、それらの指定によって取得範囲の制限か可能です。詳細内容は該当リンクをご参考頂ければ幸いです。また、下記のRest APIは認証されたユーザのみに許可されております。

閲覧APIの主なクエリパラメータ

GETメソッドでリソースを取得する閲覧APIは、リソースの範囲を指定するいくつかのクエリパラメータがあります。詳細は以前の閲覧APIを見て頂きたいですが、主に使うパラメータは下記の通りです。

閲覧時の制限事項(offsetとlimit)

Xpelntyの閲覧APIには、システムの影響を考慮した返却リストの閾値を設けております。閾値に関わるパラメータとしてoffsetとlimitがあります。 2つのパラメータを指定なしで閲覧APIが呼び出された場合、デフォルトとしてoffset = 0limit = 20が閲覧APIに付与されます。また、limitの最大値は100まで指定できるので、閲覧用のRest APIを使う際にoffsetとlimitの適切な値の調整をお勧めします。

終わりに

以上でXplentyが提供しているRest APIの中で閲覧系について色々見てみました。次はRest APIを使用してどのようにXplentyにデータ転送を行うかについてご紹介します。 XplentyはITのバッググラウンドがない方のみならず、ITに慣れている方にも便利に使うための柔軟な環境を提供しております。 優れたXplentyの利便性を2週間の無料トライアルで、ぜひお試しください。
最終更新日 2026年7月13日