API連携ガイド

コネクテッドコンテンツで呼び出すAPIを開発・点検する開発チーム向けの内容です。マーケターには、APIのURL、リクエスト方式、認証方式、レスポンス例（JSON）を共有してください。

FlareLaneは固定IPから呼び出します。ファイアウォールでアクセスを制限している場合は、担当マネージャーから送信元IPを受け取り、許可リストに追加してください。すべての呼び出しには以下のヘッダーが付きます。

• 呼び出し数は受信者数と同じではありません。ディレクティブごとに呼び出され、再処理時に再度呼び出されることがあり、キャッシュによって減ることもあります。
• 大量配信に使うAPIであれば、受信者数より多いリクエストにも耐えられる必要があります。429レスポンスが繰り返されると、サーキットブレーカーが作動する原因になります。
• クーポン発行のように呼び出しのたびに結果が生じるAPIは、同じリクエストが再度届いても結果が重複しないようにしてください。例: すでに発行したクーポンをそのまま返す

呼び出しが失敗すると、メッセージには空欄だけが残ります。サーバーログで、FlareLaneからのリクエスト（User-Agent とリクエストIDヘッダーで識別）のレスポンスコードを確認してください。