10sec Tips

10秒tips

末尾のスラッシュ「/」で動かない!?LINE Messaging APIのエンドポイント指定ミスを防ぐ鉄則

「ドメインもアクセストークンも合っているはずなのに、なぜかエラーになる……」「テスト送信が通らない……」そんな経験はありませんか?

LINE Messaging API連携でリクエストが弾かれる原因の多くは、実はURL末尾の余計なスラッシュ「/」や、文字列結合時の些細なミスにあります。

今回は、開発・実装時にハマりやすい「正しいエンドポイント指定の落とし穴と対策」をサクッと解説します!

⚡ 10秒でわかる重要ポイント

  • 末尾のスラッシュ「/」は厳禁 一般的なWebサイトと異なり、APIでは末尾スラッシュの有無で別URLと判定され、動作が保証されなくなります 。
  • 文字列の結合ミスに注意 ドメインとパスを単純連結した際の「スラッシュ重複(//)」や「区切り欠落」が頻発するミスの典型です。
  • Webhookとエンドポイントを混同しない Webhookは「LINEから自社システムへの受信」、エンドポイントは「自社システムからLINEへの送信」です。
  • 公式SDKの活用が安全策 URLを手動で組み立てる必要がなくなり、初歩的な指定ミスを大幅に削減できます。

❌ よくあるNG例 vs ⭕ 正しい指定(プッシュメッセージの例)

  • ❌ NG(末尾スラッシュあり) https://api.line.me/v2/bot/message/push/
  • ❌ NG(スラッシュ重複) https://api.line.me//v2/bot/message/push
  • ⭕ 正しい指定 https://api.line.me/v2/bot/message/push

🛠️ 実装・運用時のチェックリスト

  1. リファレンスの完全一致を意識する パスの大文字・小文字、バージョン、末尾の記号までリファレンス記載の文字列をそのまま指定する。
  2. 送信ログ・実リクエストを確認する 設定ファイル上の文字列だけでなく、実際に送信されたHTTPリクエストのURLやステータスコードを確認する。
  3. 公式SDK(Java / PHP / Python / Node.js / Go / Ruby 等)を活用する エンドポイントを意識せずに安全なリクエスト処理を呼び出せる構成を優先する。