チケットの更新

チケット情報を変更する機能を提供します。

リクエスト方式

PUT

呼び出しアドレス

https://livedesk-api.engagelab.com/api/v2/accounts/tickets/:ticket_id

呼び出し検証

詳細はAPI概要の認証方式の説明を参照してください。

リクエスト

リクエスト例

curl -X PUT 'https://livedesk-api.engagelab.com/api/v2/accounts/tickets/:ticket_id' \ -H 'Content-Type: application/json' \ -H 'Authorization: Basic base64(api_key:api_secret)' \ -d '{ "title": "プリンター紙詰まり、印刷不可（更新済み）", "description": "顧客よりA4用紙が排紙トレイで詰まったとの報告あり、緊急対応が必要。\n技術者を派遣済み。", "attachments": [ { "file_url": "https://example.com/files/error-photo.jpg" } ], "priority": "normal", "ticket_type": "incident", "custom_fields": { "department": "ITサポート", "device_sn": "PRN-2024-001", "location": "北京本社-3階印刷室", "resolution_note": "給紙ローラーを交換" }, "tags": ["printer", "hardware", "resolved"] }'

              
              curl -X PUT 'https://livedesk-api.engagelab.com/api/v2/accounts/tickets/:ticket_id' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic base64(api_key:api_secret)' \
-d '{
  "title": "プリンター紙詰まり、印刷不可（更新済み）",
  "description": "顧客よりA4用紙が排紙トレイで詰まったとの報告あり、緊急対応が必要。\n技術者を派遣済み。",
  "attachments": [
    {
      "file_url": "https://example.com/files/error-photo.jpg"
    }
  ],
  "priority": "normal",
  "ticket_type": "incident",
  "custom_fields": {
    "department": "ITサポート",
    "device_sn": "PRN-2024-001",
    "location": "北京本社-3階印刷室",
    "resolution_note": "給紙ローラーを交換"
  },
  "tags": ["printer", "hardware", "resolved"]
}'

このコードブロックはフローティングウィンドウ内に表示されます

リクエストヘッダー

フィールド	タイプ	説明
Authorization	string	`Authorization: Basic base64(API Key:API Secret)`を使用して認証を行います。APIキーページにアクセスしてAPI KeyとAPI Secretを取得し、両者をコロンで連結した後にBase64エンコードしてください。
Content-Type	application/json	データタイプ。application/jsonを使用します。

パスパラメータ

フィールド	タイプ	必須	説明
ticket_id	String	はい	チケットID。

リクエストボディパラメータ

フィールド	タイプ	必須	説明
title	String	はい	チケットタイトル。
description	String	はい	チケット詳細説明（Markdownをサポート）。
attachments	Array	いいえ	チケットレベルの添付ファイルリスト。 file_url: ファイルアドレス。
priority	String	いいえ	優先度：low/medium/high/urgent。指定しない場合はデフォルトでmedium。
ticket_type	String	いいえ	チケットタイプ：incident/question/problem/task。
custom_fields	Object	いいえ	カスタムフィールド（デバイスシリアル番号、注文番号など）。
tags	Array	いいえ	チケットタグ。

レスポンス例

成功レスポンス

{ "code": 0, "message": "Success", "data": { "ticket_id": "tk_20251104_789abc", "updated_at": "2025-11-04T10:30:00+08:00" } }

              
              {
  "code": 0,
  "message": "Success",
  "data": {
    "ticket_id": "tk_20251104_789abc",
    "updated_at": "2025-11-04T10:30:00+08:00"
  }
}

このコードブロックはフローティングウィンドウ内に表示されます

レスポンスパラメータ

フィールド	タイプ	必須	説明
ticket_id	String	いいえ	チケットID。
updated_at	String	いいえ	更新時間。