API 呼び出し失敗のトラブルシューティング

 

この記事では、お客様でAPIの失敗につながった状況について共有します。ほとんどの場合、失敗したAPIコールについてL2L Supportにお問い合わせいただいた際には、以下のいずれかが原因であることが判明します。いつでもお気軽にお問い合わせください。一緒に問題のトラブルシューティングをお手伝いします。 

また、お客様ご自身の現地IT部門にも必ず関与してもらうことが重大です。お客様のローカルネットワークまたはファイアウォールに変更が加えられると、それ以前は正常に動作していたAPIコールが失敗することがあります。 

 

APIコールが失敗する場合、一般的には以下のいずれかの理由によるものです: 

1. 顧客サイト内部のファイアウォールがAPIコールをブロックしている 

2. IPアドレスが変更された、または以前ホワイトリストに登録されていたIPアドレスが現在は登録されていない 

3. APIコールの構文が正しくない。これは頻繁に見られる事象で、通常は以下の結果として発生します: 

• 必須パラメータが不足している 
• CODEが必要な箇所で、コールに名前または説明が使用されている 
• 通常、2,000件を超えるレコードを取得しようとしたことが原因で、コールがタイムアウトする 
• APIトラフィックが繰り返し発生している、または非常に高いことが原因で、コールがタイムアウトする 

ファイアウォールがトラフィックを制限する理由はいくつかあります。以下のいずれかが発生していないか、現地のIT担当者に確認してください: 

• IPアドレスが変更された 
• プロキシ設定エラー 
• ライセンスの有効期限切れ 
• ファイアウォールポリシーの変更 

失敗したAPIコールをより迅速にトラブルシューティングできるよう、L2L Supportに提供していただきたい情報の一覧です: 

• 使用していた正確なAPIコール 
• 返された結果またはエラーメッセージ 
• このAPIコールは以前正常に動作していましたか? 
• 動作しなくなったのはいつですか? 日付と時刻もお知らせいただくと、現地のITチームとL2L Supportの双方にとってトラブルシューティングのプロセスが迅速になります。 
• 現地のIT担当者に連絡しましたか? 
• IT部門がホワイトリスト登録済みのIPアドレスに変更を加えましたか?