긴급알림 피드백 등록/확인 – Kakao Shopping Open API

긴급알림 상세 목록을 조회합니다.

특정 긴급알림에 대해 댓글을 등록하거나 확인 처리할 수 있습니다.
상세조회 응답의 판매자 댓글 등록 가능 여부(commentRegistrableYn) 값을 기준으로 처리합니다.

commentRegistrableYn=Y
: 처리유형(actionType) = COMMENT 만 허용합니다.
: 댓글내용(comment.content) = 필수
: 첨부파일 = 선택
: 처리 성공 시 응답의 actionType = COMMENT, status = PROCESSING 입니다.
commentRegistrableYn=N
: 처리유형(actionType) = CONFIRM 만 허용합니다.
: 댓글내용(comment.content) = 입력해도 무시 처리
: 첨부파일 = 입력해도 무시 처리
: 처리 성공 시 응답의 actionType = CONFIRM, status = COMPLETED 입니다.

commentRegistrableYn 값과 맞지 않는 actionType 으로 요청하면 400 을 반환합니다. 이미 종결(status=CLOSED)된 긴급알림은 추가 처리할 수 없으며 409 를 반환합니다.
동일 긴급알림에 같은 actionType 으로 여러 번 요청하면 호출할 때마다 새 댓글/상태 변경 이력이 추가됩니다. 클라이언트 측 중복 호출 방지가 필요합니다.

1. 기본 정보

메서드	URL
GET	`/v1/shopping/bizseller/emergency-article/feedback`

2. 요청 (파라미터) multipart/form-data

필드명	타입	필수여부	설명
emergencyArticleFeedback	EmergencyArticleFeedbackRequest	필수	긴급알림 피드백 요청 본문 반드시 Content-Type: application/json 으로 전송
files	File[]	선택	첨부파일 목록 actionType=COMMENT 인 경우에만 사용 최대 10개, 파일당 최대 100MB, 요청 합계 100MB 이하

EmergencyArticleFeedbackRequest 필드

필드명	타입	필수여부	설명
articleId	Long	필수	긴급알림 번호
actionType	EmergencyArticleActionType	필수	처리 유형 - COMMENT (댓글 등록 후 PROCESSING) - CONFIRM (확인 처리 후 COMPLETED)
comment	Object	비필수	댓글 정보 actionType=COMMENT 인 경우 필수
comment.content	String	비필수	댓글 내용 actionType=COMMENT 인 경우 필수이며 최대 5000자

허용 파일 형식

파일은 확장자와 Content-Type 둘 다 화이트리스트와 매칭되어야 합니다. Content-Type 이 누락되거나 빈 값이면 거부됩니다.

확장자 : jpg, jpeg, gif, png, tif, tiff, pdf, zip, ppt, pptx, xls, xlsx, hwp, hwpx, doc, docx
Content-Type : application/octet-stream 또는 MS Office 계열(vnd.ms-excel, vnd.ms-powerpoint, msword, vnd.openxmlformats-officedocument.*) 및 위 확장자에 대응하는 표준 MIME (예: application/pdf, image/png, application/x-hwp 등)

4. 응답

아래 데이터 타입 > EmergencyArticle 을 그대로 반환합니다. 상세조회 응답의 content 는 축약되지 않은 전체 내용으로 제공됩니다.
본문 첨부파일은 articleAttachedFileList, 댓글 첨부파일은 commentList[].commentAttachedFileList 에 각각 fileId 와 fileName 으로 제공됩니다.

5. 예제

1) 호출

EmergencyArticleFeedback part 본문 (JSON):

{
  "articleId": 673413,
  "actionType": "COMMENT",
  "comment": {
    "content": "확인했습니다. 5월 22일 오전까지 반영하겠습니다."
  }
}

curl 예시

curl -X POST 'https://kapi.kakao.com/v1/shopping/bizseller/emergency-article/feedback' \
  --header 'authorization: KakaoAK {대행사인증키}' \
  --header 'target-authorization: KakaoAK {판매자인증키}' \
  --header 'channel-ids: 1,101' \
  -F 'emergencyArticleFeedback={"articleId":673413,"actionType":"COMMENT","comment":{"content":"확인했습니다."}};type=application/json' \
  -F 'files=@guide.pdf;type=application/pdf'

2) 응답

필드명	타입	필수여부	설명
articleId	Long	필수	긴급알림 번호
actionType	EmergencyArticleActionType	필수	실제 처리 유형
status	EmergencyArticleStatus	필수	처리 후 상태
commentId	Long	비필수	등록된 댓글 ID actionType=CONFIRM 인 경우 null
processedAt	DateTime	필수	처리 시각. yyyy-MM-dd HH:mm:ss (KST)

{
  "articleId": 673413,
  "actionType": "COMMENT",
  "status": "PROCESSING",
  "commentId": 12345,
  "processedAt": "2026-05-20 10:00:00"
}

3) 응답 에러

HTTP	케이스
400	emergencyArticleFeedback part 의 JSON 형식 오류 필수 필드 누락 actionType 와 commentRegistrableYn 불일치 actionType=COMMENT 인데 comment.content 누락 첨부파일 개수(10개)·단건 크기(100MB)·요청 합계(100MB)·형식 위반
401	인증 실패
404	존재하지 않는 articleId / 다른 판매자의 articleId
409	이미 종결된 긴급알림에 처리 요청
500	서버 내부 오류 (첨부파일 업로드 실패 등)

이 섹션의 문서