CSVインポート時のAPIリクエスト数のカウント方法と上限に関する仕様
インポートで21件以上のデータを登録した際、リクエスト上限(20回/分)を超過することはありますか?
いいえ、21件以上のデータをインポートした場合であっても、それが原因で「1分間に20リクエスト」の上限を超過することはありません。
インポート処理は、データが何件含まれていても「1回の一括処理」として実行されるため、レコード件数分(21回分など)のAPIリクエストが消費されることはありません。
インポートとAPIリクエスト上限に関する仕様
API連携オプション(スタンダードプラン)における「1環境あたり1分間に20リクエストまで」という制限に関して、インポート時の挙動は以下の通りです。
1. インポート処理自体によるリクエストのカウント
外部システムからAPI(CSVデータインポートAPIなど)を用いてデータを取り込む場合、ファイル内に含まれるデータが21件以上(数百件〜数千件)あっても、消費されるAPIリクエストは「1回」のみです。取り込みデータ数に応じてリクエスト回数が加算されることはありません。
2. インポート完了後の自動処理における「HTTP送信パーツ」の制限
「インポート後に自動処理で外部システムへHTTP送信(APIリクエスト)を行っている場合、取り込んだ件数分だけ連続送信されて上限を超えてしまうのではないか」というご質問をいただくことがございます。
「楽楽販売」の仕様上、インポート後に実行する自動処理や、一覧画面からの「一括実行(タイマー起動含む)」において、HTTP送信パーツは実行されない制限となっております(大量通信によるサーバー高負荷やエラーを防ぐための安全仕様です)。
そのため、インポートを起点としてHTTP送信パーツが21回連続で送信されること自体がございません。
※なお、HTTP送信パーツ(「楽楽販売」 ⇒ 外部システムへの送信)は「楽楽販売」側の「20回/分」というリクエスト上限のカウント対象外です(送信先である外部システム側の受信上限に依存します)。
大量データを外部システムへ連携したい場合の推奨設計
「インポート完了と同時に、登録された大量データを外部システムへ自動連携したい」という運用を行いたい場合は、「楽楽販売」からプッシュ送信するのではなく、外部システム側から「楽楽販売のデータを取得する「PULL型」の設計を推奨いたします。
外部システム主導で「CSVエクスポートAPI」を呼び出す運用
外部システム側で定期実行プログラム(バッチ処理)を組み、楽楽販売の「CSVエクスポートAPI」を実行して対象データを取得します。
- 分割リクエスト(ページネーション): 1回あたりの出力件数上限(スタンダードプラン:200件)に合わせて、パラメータの
limitとoffsetを加算しながら複数回に分けて取得します。 - 流量制御(スリープ処理)の実装: 連続でリクエストを送信する際、1分間に20回を超えないよう、プログラム側でリクエスト間に数秒の待機時間(ウェイト)を設けてください。
関連マニュアル
API連携の制限仕様や、分割リクエストの実装手順については下記記事をご確認ください。
プランごとのリクエスト上限値や制限を超えた場合の挙動について
スタンダードプランにおける「1分間あたり20リクエスト」の詳しいカウント方法
API連携オプション:スタンダードプランにおける「1分間あたり20リクエスト」のカウント方法
お問い合わせフォームよりご要望をお寄せください。
「楽楽販売」はお客様から頂戴したご意見・ご要望をもとに、
よりよく、寄り添う 販売管理クラウドを目指してまいります。
現在の仕様ではご希望の機能に対応しておりませんが、
お客様からの貴重なご意見として真摯に受け止め、今後の改善に役立ててまいります。
(記事ID:3116)
「API連携オプション」の関連記事一覧
こちらの記事もあわせてご確認ください。
- 外部システム側でIPアクセス制限を行う場合に「楽楽販売」の送信元IPアドレスを確認・登録する方法
- ユーザー設定画面に「API」項目が表示されない原因と表示させるための設定手順
- 外部システム連携機能における連携成否の判定基準と通信仕様について
- Google Apps Script(GAS)からAPI接続を行う際のIPアドレス制限設定について
- API連携における「APIのアクセス制限」設定の仕様と通信の挙動について
- CSVデータインポートAPIで登録・更新できるデータの範囲について
- CSVデータインポートAPIを利用して外部システムからデータを一括更新・登録する手順
- API連携でDBリンク項目や選択肢項目に値を指定してレコードを登録する方法
- 「楽楽販売」とGoogleカレンダー/OutlookカレンダーのAPI連携について