---
title: "TNP API 1.20.7"
description: "패키징 작업(Job)이 실패할 경우, AWS SNS 알림 메시지 페이로드에 errorcode 및 errormessage 필드가 포함되어 전송됩니다."
---
> For the complete documentation index, see [llms.txt](/llms.txt).

**개선 사항: SNS 작업 상태 알림에 에러 정보 추가**

패키징 작업(Job)이 실패할 경우, AWS SNS 알림 메시지 페이로드에 `error_code` 및 `error_message` 필드가 포함되어 전송됩니다.

기존에는 `ERROR` 상태 알림이 수신되더라도 실패 원인을 별도 API 호출로 조회해야 했습니다. 이번 업데이트를 통해 실패 원인이 상태 변경 이벤트와 함께 즉시 전달되므로, 자동화된 알림·트리아지·재처리 로직을 보다 신속하게 처리할 수 있습니다.

**업데이트된 SNS 알림 페이로드 예시 (ERROR 상태):**

json

```
{
  "site_id": "XXXX",
  "job_id": 12345,
  "job_status": "ERROR",
  "error_code": "E8005",
  "error_message": "Failed to segmenting and DRM packaging.",
  "user_data": {},
  "reg_time": "2026-03-10T01:00:00Z",
  "start_time": "2026-03-10T01:00:05Z",
  "update_time": "2026-03-10T01:02:30Z"
}
```

- `error_code` 및 `error_message`는 `job_status`가 `ERROR`인 경우에만 포함되며, 그 외 상태에서는 해당 필드가 생략되거나 `null`로 반환됩니다

- 고객이 직접 조치 가능한 에러(예: 잘못된 입력 파일, 지원하지 않는 코덱, S3 접근 거부 등)의 경우, 메시지에 구체적인 조치 방법이 포함됩니다

- 서버 내부 에러의 경우, Helpdesk 문의를 안내합니다


**기존 SNS 연동에 별도 조치는 필요하지 않습니다** — 신규 필드는 기존 페이로드에 추가된 것으로 하위 호환성이 유지됩니다. 단, SNS 수신 측에서 엄격한 스키마 검증(strict schema validation)을 사용하는 경우, 신규 필드를 수용하도록 업데이트가 필요할 수 있습니다.