# 開発ガイドライン

Messaging APIを使ったLINEボットを開発する際は、以下の開発ガイドラインに従ってください。

注意

LINEボット開発における基本ルールは、規約とポリシーに記載される内容に基づきます。

# LINEプラットフォームへの大量リクエストの禁止

負荷テストや動作テストを目的に、LINEプラットフォームへ、大量のリクエストを送信しないでください。

なお、いかなる目的でもレート制限を超えてリクエストを送信しないでください。

注意

レート制限を超えて送信を行った場合、429 Too Many Requestsが返却され、エラーとなります。

レート制限内の動作テスト

レート制限内であっても以下のようなリクエストを高頻度で行うことは禁止します。

LINEプラットフォームから、ボットサーバーに負荷テストを行うサービスはありません。

負荷テストを目的に、大量のメッセージをLINEプラットフォームを経由して送信しないでください。ボットサーバーの負荷テストを行うための環境は、別途用意してください。

いかなる目的でも、同一ユーザーへメッセージを大量送信しないでください。

リクエストを送信するときは、存在しないユーザーIDを指定しないでください。

特定のユーザーIDに対して、ユーザーの属性を特定する行為は行わないでください。また、属性の特定を目的としてオーディエンス管理のAPIを利用したり、ナローキャストメッセージを配信したりしないでください。

Webhookを受信するボットサーバーにおいて、Webhookリクエスト送信元のLINEプラットフォームのIPアドレスでアクセス制限をしないでください。

LINEプラットフォームのIPアドレスは開示していません。また、IPアドレスは予告なく変更される場合があります。

不正なアクセス元からのリクエストを拒否したい場合は、IPアドレスによる制限ではなく、Webhookの署名の検証を実施してください。

問題が発生した際に、開発者自身が原因や影響範囲の調査を円滑に行えるよう、Messaging APIに対するリクエストのログや、Webhook受信時のログを一定期間保存することを推奨します。

Messaging APIに対するリクエストを行った際は、以下の情報をログとして保存することを推奨します。

具体的には、以下のような形式でログファイルなどに保存します。

リクエストID（`x-line-request-id`）	APIリクエストを行った時間	リクエストメソッド	APIエンドポイント	ステータスコード
8e36bade-c5d6-4d00-9e69-72244675a9a1	Mon, 05 Jul 2021 08:14:35 GMT	POST	https://api.line.me/v2/bot/message/push	200

ボットサーバーでLINEプラットフォームからのWebhookを受信した際は、以下の情報をログとして保存することを推奨します。

具体的には、以下のような形式でログファイルなどに保存します。

送信元IPアドレス	Webhookを受信した時間	リクエストメソッド	リクエストのパス	ステータスコード
203.0.113.1	Mon, 05 Jul 2021 08:10:00 GMT	POST	/linebot/webhook	200

追加でログに保存しておくと有用な情報

運用するボットの要件等によっては、上記に加えて、たとえば以下のような情報を保存しておくことで、問題が発生した際の調査をより円滑に行うことができます。

ログの提供は行っておりません

Messaging APIに対するリクエストのログや、LINEプラットフォームからボットサーバーへのWebhook送信時のログ等は、お問い合わせいただいても提供は行っておりません。ログの保存は、LINEボットを開発する開発者自身で行ってください。