긴급알림 상세 목록을 조회합니다.
|
특정 번호의 긴급알림 상세 내용을 조회할 수 있습니다. 민감 정보인 개인정보(personalInfo)와 축약되지 않은 전체 내용(content)은 상세조회 API에서만 확인할 수 있습니다. commentList 는 긴급알림 등록일시(createdAt) 기준 오름차순으로 정렬되며, 첨부파일 배열은 표시 순서대로 정렬되어 응답됩니다. *개인정보(personalInfo)가공 규칙 |
1. 기본 정보
| 메서드 | URL |
|---|---|
| GET | /v1/shopping/bizseller/emergency-article/detail |
2. 요청 (파라미터)
| 필드명 | 타입 | 필수여부 | 설명 |
|---|---|---|---|
| articleId | Long | 필수 |
조회하려는 긴급알림 번호 |
3. 응답
조회가 성공하면 긴급알림 상세 정보가 응답 바디에 포함되며, 데이터 타입 > EmergencyArticle 을 그대로 반환합니다. 상세조회 응답의 content 는 축약되지 않은 전체 내용으로 제공됩니다.
본문 첨부파일은 articleAttachedFileList, 댓글 첨부파일은 commentList[].commentAttachedFileList를 통해 fileId와 fileName 정보만 조회할 수 있습니다.
4. 예제
1) 호출
curl -X GET 'https://kapi.kakao.com/v1/shopping/bizseller/emergency-article/detail?articleId=673413' \
--header 'authorization: KakaoAK {대행사인증키}' \
--header 'target-authorization: KakaoAK {판매자인증키}' \
--header 'channel-ids: 1' \
--header 'Content-type: application/json'2) 응답
{
"articleId": 673413,
"sellerName": "테스트",
"channelName": "선물하기",
"category1depthId": 3,
"category1depthName": "배송",
"categoryId": 17,
"categoryName": "배송일정_지연",
"personalInfo": "",
"content": "안녕하세요, 카카오쇼핑 고객센터입니다.\n해당 주문건에 대해 배송이 늦어지고 있어 배송일정 문의드립니다.\n\n* 회신 요청 사항\n- 상품의 배송(출고)일정\n- 배송 지연 사유\n\n감사합니다.",
"status": "PROCESSING",
"longUnprocessedYn": "N",
"commentRegistrableYn": "Y",
"commentList": [
{
"commentId": 10001,
"content": "확인했습니다. 5월 22일 오전까지 출고 예정이며, 물류센터 입고 지연으로 배송이 늦어졌습니다.",
"createdBy": "SELLER",
"createdAt": "2026-05-20 09:30:00",
"commentAttachedFileList": [
{ "fileId": 12345, "fileName": "delivery-plan.pdf", "downloadUrl": "https://stwg.kakaocdn.net/kakao_shopping_private/xxxx.pdf?TWGServiceId=...&Expires=...&Signature=..." },
{ "fileId": 12346, "fileName": "delay-reason.png", "downloadUrl": "https://stwg.kakaocdn.net/kakao_shopping_private/yyyy.png?TWGServiceId=...&Expires=...&Signature=..." }
]
}
],
"articleAttachedFileList": [
{ "fileId": 12300, "fileName": "guide.pdf", "downloadUrl": "https://stwg.kakaocdn.net/kakao_shopping_private/zzzz.pdf?TWGServiceId=...&Expires=...&Signature=..." }
],
"articleProductOrderList": [
{
"productId": 80552963,
"productName": "테스트1번",
"orderId": 1183851797,
"optionName": null
}
],
"createdAt": "2026-05-19 14:18:00",
"modifiedAt": "2026-05-20 09:30:00"
}3) 응답 에러
| HTTP | 케이스 |
|---|---|
401 |
인증 실패 |
404 |
존재하지 않는 articleId / 다른 판매자의 articleId / 비노출 처리된 긴급알림 |
500 |
서버 내부 오류 (개인정보 복호화 실패 등) |