API連携でエラーが発生した場合の原因特定と対処手順（403・401・400エラー）

API連携時のエラーは、接続元IPアドレスの未登録（403）、APIトークンの不一致・未確定（401）、またはリクエストパラメータの記述ミス（400）が主な原因です。
返却されたレスポンス内のエラーコードをご確認ください。

「楽楽販売」のWeb API連携でエラーが発生した場合、実行側のシステムに返却されるAPIレスポンスに含まれるエラーコード（code）やメッセージ（msg）から原因を特定できます。

エラー403「アクセスが拒否されました」が出ている場合（IPアドレスの確認）

外部システム（RPAや自社プログラム等）からの通信許可設定が不足している場合に発生します。外部システムの接続元（グローバルIPアドレス）が「楽楽販売」側に登録されていないと、セキュリティ保護のため通信が遮断されます。

【設定箇所】 [管理者設定] ＞ [セキュリティ設定]タブ ＞ IPアクセス制限に関する設定

【対処手順】

1. 「APIのアクセス制限」欄を確認します。
2. APIを実行する外部システムの送信元グローバルIPアドレスが登録されているか確認します。
3. 未登録の場合は、該当のIPアドレス（またはサブネット範囲）を追加し、画面下部の「確定」ボタンをクリックして保存します。

エラー401「認証エラーです」が出ている場合（APIトークンの確認）

APIトークンが正しく設定されていないか、トークン生成後に保存処理が行われていない場合に発生します。

【設定箇所】 [管理者設定] ＞ [ユーザ設定]タブ ＞ ユーザ管理

【対処手順】

1. API連携に使用しているユーザーの「設定」画面を開きます。
2. APIトークンを発行（または再発行）した後、必ず画面下部の「確定」ボタンを押して保存してください（「確定」を押さないと新しいトークンは有効化されません）。
3. 確定後、ユーザー一覧でAPIトークン欄にチェックマークが付いていることを確認し、外部システム側の設定値を新しいトークンへ書き換えてください。

エラー400「パラメータが不正です」が出ている場合（リクエストJSONの確認）

送信しているリクエストパラメータ（JSON）の記述ミスや型の不一致、必須項目の不足により発生します。

【確認・対処手順】

1. 大文字・小文字の区別： パラメータ名の大文字・小文字（例：KeyId ではなく keyId、dbSchemaId など）が一字一句合っているか確認します。
2. 不要な空白・改行の除外： パラメータ前後に不要なスペースや改行コードが含まれていないか確認します。
3. パラメータの型と必須条件： 文字列型／数値型の指定が正しく、マニュアルに記載された必須項目（dbSchemaId や id / keyId など）が含まれているか確認します。

関連記事

接続先URLやリクエストパラメータの構成ルールについては、下記マニュアルをご確認ください。

API連携オプション：設定方法

API連携の接続先URLや、リクエストパラメータの構成規則について詳しく解説しています。
API連携オプション：設定方法

（記事ID：3069）