> ## Documentation Index
> Fetch the complete documentation index at: https://docs.utage-system.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LINEメッセージタイプ定義

> **プレビュー機能。仕様は今後変更される可能性があります。** LINEメッセージの作成・更新時に使用可能なメッセージタイプとパラメータ定義を取得します（認証不要）。

テキスト・スタンプ・画像・イメージマップ・ボタン・カルーセル・音声・動画の8タイプの定義と、ボタン/カルーセルで使えるアクションタイプの定義を返します。
メッセージ作成APIの `line.messages` 構造を組み立てる際に参照してください。


`GET`

```
https://api.utage-system.com/v1/message-types/line
```

<Note>この機能はプレビュー版です。仕様が変更される場合があります。</Note>


## OpenAPI

````yaml GET /message-types/line
openapi: 3.0.3
info:
  title: UTAGE API
  description: |
    UTAGEのパブリックAPIです。ファネル、配信アカウント、シナリオ、メディアなどのリソースをプログラムから操作できます。

    ## 認証
    すべてのリクエストにAPIキーによるBearer認証が必要です（要素タイプエンドポイントを除く）。

    ```
    Authorization: Bearer {api_key}
    ```

    APIキーはUTAGE管理画面から発行できます。

    ## レート制限
    リクエスト数には以下の制限があります。

    | 分間上限 | 日間上限 |
    |----------|----------|
    | 60リクエスト/分 | 10,000リクエスト/日 |

    レスポンスヘッダーで現在の使用状況を確認できます。

    | ヘッダー | 説明 |
    |----------|------|
    | X-RateLimit-Limit | 分間の上限値 |
    | X-RateLimit-Remaining | 分間の残りリクエスト数 |
    | X-RateLimit-Reset | 制限がリセットされるUNIXタイムスタンプ |

    上限を超えた場合は `429 Too Many Requests` が返されます。

    ## エラーレスポンス
    エラー時は以下の形式で返されます。

    ```json
    {
      "error": {
        "code": "error_code",
        "message": "エラーメッセージ"
      }
    }
    ```
  version: '1.0'
  contact:
    name: UTAGE サポート
servers:
  - url: https://api.utage-system.com/v1
    description: UTAGE API
security:
  - BearerAuth: []
tags:
  - name: ファネル
    description: ファネルの作成・更新・一覧取得
  - name: ステップ
    description: ファネル内のステップの作成・更新・並び替え
  - name: ページ
    description: ステップ内のページの作成・更新・取得・削除
  - name: 配信アカウント
    description: 配信アカウントの作成・一覧取得
  - name: シナリオ
    description: シナリオの作成・一覧取得
  - name: メディア
    description: 動画・音声・通常メディアの一覧取得とアップロード
  - name: 要素タイプ
    description: ファネルページ・HTMLメールの要素タイプ定義、LINEメッセージタイプ・配信条件タイプの取得（認証不要）
  - name: ファネル統計
    description: ファネルの集計データ・登録者・登録経路の取得（プレビュー）
  - name: 配信メッセージ
    description: 配信メッセージの作成・更新・テスト送信・配信統計、置き換え文字の取得（プレビュー）
  - name: 読者
    description: 読者の作成・更新・取得、ラベル・配信履歴・開封/クリック履歴の取得（プレビュー）
  - name: LINE
    description: LINE友だち・カスタム送信者・1対1チャット・テンプレートの操作（プレビュー）
  - name: ラベル・共通読者・登録経路
    description: ラベル・共通読者・アクション・登録経路の操作（プレビュー）
paths:
  /message-types/line:
    get:
      tags:
        - 要素タイプ
      summary: LINEメッセージタイプ定義
      description: >
        **プレビュー機能。仕様は今後変更される可能性があります。**
        LINEメッセージの作成・更新時に使用可能なメッセージタイプとパラメータ定義を取得します（認証不要）。


        テキスト・スタンプ・画像・イメージマップ・ボタン・カルーセル・音声・動画の8タイプの定義と、ボタン/カルーセルで使えるアクションタイプの定義を返します。

        メッセージ作成APIの `line.messages` 構造を組み立てる際に参照してください。
      operationId: getLineMessageTypes
      responses:
        '200':
          description: LINEメッセージタイプ定義
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      max_messages:
                        type: integer
                        description: 1メッセージあたりに含められるLINEメッセージの最大件数
                        example: 5
                      sender_id:
                        type: object
                        description: 送信者ID指定の定義（type / required / description）
                      message_types:
                        type: array
                        description: >-
                          利用可能なメッセージタイプ定義（text / sticker / image / imagemap /
                          button / carousel / audio / video）
                        items:
                          type: object
                      action_types:
                        type: array
                        description: >-
                          ボタン・カルーセルで使えるアクションタイプ定義（url / friendmessage / message
                          / template / nothing）
                        items:
                          type: object
                      action_common_options:
                        type: array
                        description: >-
                          アクション共通オプション定義（action_id / add_label_id / del_label_id
                          / reserved_word / update_value）
                        items:
                          type: object
      security: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: APIキーをBearerトークンとして指定

````