お問合せ履歴
➊ 顧客チケットリスト
(1) インターフェース説明
URL: https://{domain}.oc.nhncloud.com/{serviceId}/openapi/v1/ticket/enduser/{usercode}/list.json
URL (生産テスト環境) : https://{domain}.oc.beta-nhncloud.com/{serviceId}/openapi/v1/ticket/enduser/{usercode}/list.json
URL(開発テスト環境) : https://{domain}.oc.alpha-nhncloud.com/{serviceId}/openapi/v1/ticket/enduser/{usercode}/list.json
顧客チケットリスト
HTTPS
GET
UTF-8
JSON
検索条件により、条件に合った顧客のチケットリストを露出
共通認証
(2) リクエストパラメータ定義
サービスID
serviceId
String
path
O
サービスID，URL PATH内に設定した{serviceId}
ユーザーコード
usercode
String
path
O
ユーザーコード(唯一の値)，URL PATH内に設定した{usercode}
カテゴリーID
categoryId
Integer
query
X
カテゴリー（受付タイプ）ID
チケットの状態
status
String
query
X
チケットの状態. new: アサイン待ち, open: 処理中, reply: 保留, solved: 解決, closed: 完了
言語コード
language
String
query
X
サービスヘルプセンターの基本言語コード
チャンネル
source
String
query
X
お問い合わせチャンネル(web:PCウェブ、spweb:モバイルウェブ、api:API)。 複数のチャンネル照会時にコンマを通じて使い分け（例:web,spweb,api）。 デフォルト値はweb,spweb,api
整列方式
sort
String
query
X
整列順序(デフォルト:updatedDt:desc;整列形式:昇順:asc、降順:desc)
ページ
page
Integer
query
X
基本値: 1
1ページあたりの露出件数
pageSize
Integer
query
X
基本値: 10; max=200
(3) 結果データ
createdDt
Long
チケット作成時間
updatedDt
Long
チケットアップデート時間
displayDt
String
露出時間(yyyy.MM.dd)
result
total
Integer
総件数
pages
Integer
総ページ数
pageNum
Integer
現在のページ
pageSize
Integer
1ページあたりの露出件数
(4) Response Body
➋ チケット詳細
(1) インターフェース説明
URL: https://{domain}.oc.nhncloud.com/{serviceId}/openapi/v1/ticket/enduser/{usercode}/{ticketId}/detail.json
URL (生産テスト環境) : https://{domain}.oc.beta-nhncloud.com/{serviceId}/openapi/v1/ticket/enduser/{usercode}/{ticketId}/detail.json
URL(開発テスト環境) : https://{domain}.oc.alpha-nhncloud.com/{serviceId}/openapi/v1/ticket/enduser/{usercode}/{ticketId}/detail.json
チケット詳細
HTTPS
GET
UTF-8
JSON
顧客が受け付けたチケット詳細照会
共通認証
(2) リクエストパラメータ定義
サービスID
serviceId
String
path
O
サービスID，URL PATH内に設定した{serviceId}
ID
usercode
String
path
O
ID(ユーザー固有ID)、お問い合わせ受付時のusercode
チケットID
ticketId
String
path
O
チケットID
言語コード
language
String
query
X
サービスヘルプセンターの基本言語コード
(3) 結果データ
result.content
ticketId
String
チケットID
subject
String
サービスID
categoryId
Integer
カテゴリー（受付タイプ）ID
categoryName
String
カテゴリー名
categoryFullName
String
カテゴリー全体経路(>で各レベルを接続)
status
String
チケットの状態. new: アサイン待ち, open: 処理中, reply: 保留, solved: 解決, closed: 完了
statusName
String
チケットの状態名
content
String
問い合わせ内容
createdDt
Long
作成時間
updatedDt
Long
修正時間
contents
Array
チケット詳細
contents.content
String
内容詳細
contents.type
String
お問い合わせタイプ。enduser:お問い合わせ(受付完了)、csuser:回答(受付完了)
contents.typeName
String
内容タイプ名
contents.createdDt
Long
チケット処理時間
contents.displayDt
String
内容露出時間(yyyy.MM.dd)
contents.attachments
Array
チケット処理内容の添付ファイル
contents.attachments.attachmentId
String
チケット処理内容の添付ファイルID
contents.attachments.fileName
String
チケット処理内容の添付ファイル名
contents.attachments.contentType
String
チケット処理内容の添付ファイルタイプ
contents.attachments.disposition
String
チケット処理内容の添付ファイル処理方式(attachment:添付ファイル)
contents.attachments.size
Long
チケット処理内容の添付ファイルサイズ
contents.attachments.createdDt
Long
チケット処理内容の添付ファイルのアップロード時間
attachments
Array
チケットお問い合わせの添付ファイル
attachments.attachmentId
String
チケットお問い合わせの添付ファイルID
attachments.fileName
String
チケットお問い合わせの添付ファイル名
attachments.contentType
String
チケットお問い合わせの添付ファイルタイプ
attachments.disposition
String
チケットお問い合わせの添付ファイル処理方式(attachment:添付ファイル)
attachments.size
Long
チケットお問い合わせの添付ファイルサイズ
attachments.createdDt
Long
チケットお問い合わせの添付ファイルのアップロード時間
attachments.repealFlag
Boolean
チケットお問い合わせの添付ファイルの削除有無 - 削除 X：false - 削除 O：true
displayDt
String
露出時間(yyyy.MM.dd)
result
total
Integer
総件数
pages
Integer
総ページ数
pageNum
Integer
ページ
pageSize
Integer
1ページあたりの露出件数
(4) Response Body
➌ チケット添付ファイルを開く/ダウンロード
(1) インターフェース説明
URL: https://{domain}.oc.nhncloud.com/{serviceId}/api/v2/ticket/attachments/{id}
URL (生産テスト環境) : https://{domain}.oc.beta-nhncloud.com/{serviceId}/api/v2/ticket/attachments/{id}
URL(開発テスト環境) : https://{domain}.oc.alpha-nhncloud.com/{serviceId}/api/v2/ticket/attachments/{id}
チケット添付ファイルを開く/ダウンロード
HTTPS
GET
UTF-8
JSON
チケット添付ファイルを開く/ダウンロード
必要なし
(2) リクエストパラメータ定義
サービスID
serviceId
String
path
O
サービスID，URL PATH内に設定した{serviceId}
添付ファイルID
id
String
path
O
添付ファイルID, URL PATH内に設定した{id}
処理方式
type
String
query
X
デフォルト値:ブラウザで開く。（download:ダウンロード、open:ブラウザで開く）
(3) 結果データ
File
➍ 顧客再問合せ
(1) インターフェース説明
URL: https://{domain}.oc.nhncloud.com/{serviceId}/openapi/v1/ticket/enduser/{usercode}/{ticketId}/comment.json
URL (生産テスト環境) : https://{domain}.oc.beta-nhncloud.com/{serviceId}/openapi/v1/ticket/enduser/{usercode}/{ticketId}/comment.json
URL(開発テスト環境) : https://{domain}.oc.alpha-nhncloud.com/{serviceId}/openapi/v1/ticket/enduser/{usercode}/{ticketId}/comment.json
顧客再問合せ
HTTPS
POST
UTF-8
JSON
チケットIDを基準に再お問い合わせ
共通認証
(2) リクエストパラメータ定義
サービスID
serviceId
String
path
O
サービスID，URL PATH内に設定した{serviceId}
ID
usercode
String
path
O
ID(ユーザー固有ID)、お問い合わせ受付時のusercode
チケットID
ticketId
String
path
O
チケットID
内容
comment
String
body
O
再問合せの内容
첨부파일
attachments
String
query
X
添付ファイルID。複数のファイル添付時にファイルIDを(,)から分離、maxは5件(ファイルID1,ファイルID2,...、ファイルID5)
(3) 結果データ
result.content
content
String
再問合せの内容
type
String
固定値: enduser
typeName
String
タイプ名称
createdDt
Long
提出時間
displayDt
String
露出時間(yyyy.MM.dd)
attachments
Array
添付ファイル
attachments.attachmentId
String
添付ファイルID
attachments.fileName
String
添付ファイル名
attachments.contentType
String
添付ファイルタイプ
attachments.disposition
String
添付ファイル処理方式(attachment:添付ファイル)
attachments.size
Long
添付ファイルサイズ
attachments.createdDt
Long
添付ファイルのアップロード時間
(4) Response Body
最終更新