「楽楽販売」の自動処理における「HTTP送信」パーツは、メソッドが「GET」であるか「POST」であるかにかかわらず、送信先の外部システムから返ってきたレスポンス内容(データ)を解析して、楽楽販売の項目に自動で登録したり、後続の自動処理パーツの入力値として利用したりすることは一切できない仕組み(送信専用の仕様)となっています。
接続先の外部システムが必要とする通信規格(API仕様)に合わせて、適切なHTTPメソッド(GET/POSTなど)を選択し、リクエストヘッダやパラメータを構成して送信を行ってください。
【GETメソッドをHTTP送信パーツで利用するシーン】
接続先APIが「GETリクエストの受信をトリガーにして、連携先(外部側)で処理を完結させる」仕様になっている場合や、セキュリティの観点からGET接続を必須としている場合に、その通信規格に合わせてキック(トリガー)を送信するために選択・使用します。
「楽楽販売」側からデータを取得しに行くことはできませんが、外部システム側を起点として「楽楽販売」が提供しているAPIを呼び出すことで、データの自動登録・一括更新が可能です。
外部システム側から「楽楽販売」のAPIエンドポイントに対してデータを送信(PUSH)する仕組みを構築してください。具体的な事前準備と制御方法は以下の通りです。
APIを利用するためには「API連携オプション」のご契約が必要です。本オプションを導入いただくことで、外部システムからのAPIリクエストを受け付けることが可能になります。
【設定箇所】 管理者設定 > ユーザー設定 > ユーザー管理
API連携に利用する「システム設定権限」を持ったユーザーの「設定」画面を開き、APIトークンを生成してください。
※生成後、画面最下部の「確定」ボタンをクリックしないとトークンがシステム上で有効になりませんので必ず確定を実行してください。このトークンをリクエストヘッダ(X-HD-apitoken)に指定して認証を行います。
【設定箇所】 管理者設定 > セキュリティ設定 > IPアクセス制限に関する設定
楽楽販売のAPIセキュリティ仕様上、「IPアドレス制限サービス」オプションの契約有無にかかわらず、APIを実行する際はアクセス元(外部システム)のグローバルIPアドレスの登録が100%必須です。
設定画面内の「APIのアクセス制限」欄に、リクエストを送信してくる外部システムの送信元グローバルIPアドレスを必ず登録してください。未登録のIPアドレスからAPIを呼び出そうとすると、すべて「403 Forbidden(アクセスが拒否されました)」のエラーで強制遮断されます。
API連携のパラメータ仕様や接続に関する詳細は、下記記事をご確認ください。
APIの接続先URLの指定形式(https://【サーバ名】/【アカウント名】/api/)や、JSON形式でのパラメータ指定方法、認証に必要なAPIトークンの詳細について解説しています。
API連携オプション:設定方法
プランごとのグループ別リクエスト制限の詳細、リクエスト件数の削減に有効な「CSVデータインポートAPI」を活用したデータの一括集約連携による回避方法について詳しく解説しています。
API連携オプション:リクエスト上限の回避方法
「楽楽販売」はお客様から頂戴したご意見・ご要望をもとに、
よりよく、寄り添う 販売管理クラウドを目指してまいります。
現在の仕様ではご希望の機能に対応しておりませんが、
お客様からの貴重なご意見として真摯に受け止め、今後の改善に役立ててまいります。
(記事ID:2911)