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

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

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

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

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

【対処手順】

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

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

【対処手順】

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

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

【確認・対処手順】

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

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

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

（記事ID：3069）

関連記事