# LINEミニアプリ APIリファレンス
# サービスメッセージ
サービスメッセージAPIを使用すると、サービスからLINEミニアプリのユーザーに、サービスメッセージを送信できます。
サービスメッセージを送信するには、サービス通知トークンとテンプレートが必要です。
# サービス通知トークンを発行する
サービス通知トークンを発行します。 サービス通知トークンを使用すると、紐づけられたユーザーに対してサービスメッセージを送信できます。
サービス通知トークンの特徴は以下のとおりです。
- サービス通知トークンは、発行から1年間有効です。有効期限が切れるまでに、最大5回サービスメッセージを送信できます。
- サービス通知トークンを使用すると、有効期限が切れておらず、残りの送信可能回数が0でない場合は、サービス通知トークンの値が更新されます。ユーザーに対して、後続のサービスメッセージを送信する場合は、更新後のサービス通知トークンを保存してください。
サービス通知トークンは、一人のユーザーに紐づいています。あるユーザーに紐づいたサービス通知トークンを利用して、ほかのユーザーにサービスメッセージを送信することはできません。
リクエストの例
# HTTPリクエスト
POST https://api.line.me/message/v3/notifier/token
# リクエストヘッダー
Content-Type
application/json
Authorization
Bearer {channel access token}
詳しくは、「チャネルアクセストークン」を参照してください。
任意の有効期間を指定できるチャネルアクセストークン(チャネルアクセストークンv2.1)は、使用できません。
# リクエストボディ
liffAccessToken
String
liff.getAccessToken()
で取得したユーザーアクセストークン
# レスポンス
ステータスコード200
と以下の情報を含むJSONオブジェクトを返します。
notificationToken
String
サービス通知トークン
expiresIn
Number
サービス通知トークンの有効期限が切れるまでの秒数
remainingCount
Number
発行されたサービス通知トークンで、サービスメッセージを送信できる回数
レスポンスの例
# エラーレスポンス
以下のいずれかのステータスコードとエラーメッセージを返します。
ステータスコード | 説明 |
---|---|
400 Bad request | 以下のどちらかです。
|
403 Forbidden | このチャネルには、サービスメッセージを送信する許可が与えられていません。 |
500 Internal Server Error | 内部サーバーのエラーです。 |
エラーレスポンスの例
# サービスメッセージを送る
サービス通知トークンで指定されたユーザーに、サービスメッセージを送信します。
サービスメッセージを送信すると、有効期限が切れておらず、残りの送信可能回数が0でない場合は、サービス通知トークンの値が更新されます。 ユーザーに対して、後続のサービスメッセージを送信する予定がある場合は、更新後のサービス通知トークンを保存してください。
リクエストの例
# HTTPリクエスト
POST https://api.line.me/message/v3/notifier/send
# リクエストヘッダー
Content-Type
application/json
Authorization
Bearer {channel access token}
詳しくは、「チャネルアクセストークン」を参照してください。
任意の有効期間を指定できるチャネルアクセストークン(チャネルアクセストークンv2.1)は、使用できません。
# クエリパラメータ
target
service
# リクエストボディ
templateName
String
サービスメッセージに使用する、事前登録済みテンプレートの名前。BCP 47言語タグを末尾に追加してください。
- フォーマット:
{template name}_{BCP 47 language tag}
- 最大文字数:30
サービスメッセージでサポートしている言語と言語タグは、以下のとおりです。
- アラビア語:
ar
- 中国語(簡体字):
zh-CN
- 中国語(繁体字):
zh-TW
- 英語:
en
- フランス語:
fr
- ドイツ語:
de
- インドネシア語:
id
- イタリア語:
it
- 日本語:
ja
- 韓国語:
ko
- マレー語:
ms
- ポルトガル語(ブラジル):
pt-BR
- ポルトガル語(ポルトガル):
pt-PT
- ロシア語:
ru
- スペイン語(スペイン):
es-ES
- タイ語:
th
- トルコ語:
tr
- ベトナム語:
vi
params
object
テンプレート変数と値のペアを指定するJSONオブジェクト。
テンプレートにテンプレート変数がない場合は、空のJSONオブジェクト({ }
)を指定します。
テンプレート変数は、テンプレートごとに定義されています。
必須の要素にテンプレート変数が含まれる場合は、必ずテンプレート変数と値のペアを指定してください。
notificationToken
String
サービス通知トークン
# レスポンス
ステータスコード200
と以下の情報を含むJSONオブジェクトを返します。
notificationToken
String
更新後のサービス通知トークン。 このサービス通知トークンを使用して、後続のサービスメッセージを送信します。
expiresIn
Number
更新後のサービス通知トークンの有効期限が切れるまでの秒数
remainingCount
Number
更新後のサービス通知トークンで、後続のサービスメッセージを送信できる回数
notifiationToken
、expiresIn
、remainingCount
に、空の文字列および0
が設定されている場合は、サービスメッセージは送信されたが、サービス通知トークンが更新できなかったことを示します。- 空のJSON(
{ }
)が返された場合は、同じ内容で複数回リクエストしたことを示します。
レスポンスの例
# エラーレスポンス
以下のいずれかのステータスコードとエラーメッセージを返します。
ステータスコード | 説明 |
---|---|
400 Bad request | 以下のいずれかです。
|
401 Unauthorized | 有効なチャネルアクセストークンが指定されていません。 |
403 Forbidden | このチャネルには、サービスメッセージを送信する許可が与えられていません。 |
404 Not found | 指定されたテンプレートが見つかりません。 |
500 Internal Server Error | 内部サーバーのエラーです。 |
エラーレスポンスの例