> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/partner/ko/deprecation-schedule-policy/api-deprecation-policy.md).

# API 지원 중단 정책

## 사용 중단하는 이유

여기 Epsilon Retail Media 에서는 지속적으로 새로운 제품과 기능을 반복 개선하고 도입하고 있습니다. 이에 따라 API 변경은 불가피합니다. 사용자가 이러한 변경 사항을 계획할 수 있도록, 더 나은 버전이 제공되거나 기능의 지원 종료 시점이 다가오거나 종료된 경우 당사는 지원 중단 정책을 따릅니다.

특정 버전에 대한 지원 중단 기간은 지원 중단 발표일에 시작됩니다. 지원 중단 대상으로 표시된 버전은 3개월의 지원 중단 기간 동안 계속 사용할 수 있습니다. 지원 중단 기간이 지나면 해당 버전은 폐기될 예정이며, Epsilon Retail Media 은(는) 더 이상 일몰(sunset) 이후 해당 버전을 사용할 수 있다고 보장할 수 없습니다.

## API에 적용되는 지원 중단 강제 규칙

1. 제거된 API 요소와 같은 파괴적 변경(Breaking changes)은 API 버전을 올려야만 도입됩니다.
   * 특정 버전에서 API 요소가 추가되면 해당 버전에서 제거하거나 동작을 크게 변경할 수 없습니다.
2. API 객체는 일부 버전에 존재하지 않는 전체 REST 리소스를 제외하고, 최신 릴리스 내의 API 버전 간에 정보 손실을 최소화하거나 전혀 없이 상호 전환(round-trip)될 수 있어야 합니다.
   * 예를 들어, 객체를 v1으로 작성한 다음 v2로 읽어 돌아와서 v1으로 변환할 수 있으며, 그 결과 생성된 v1 리소스는 원본과 동일합니다. v2의 표현은 v1과 다를 수 있지만 시스템은 양방향으로 전환하는 방법을 알고 있습니다. 또한 v2에 추가된 모든 새 필드는 v1으로 상호 전환될 수 있어야 합니다. 즉, v1은 동등한 필드를 추가하거나 동등한 필드에 매핑하거나 주석(annotation)으로 표현해야 할 수 있습니다.
   * 중요한 제품 기능 변경의 경우, 당사는 API가 하위 호환성을 유지하도록 설계하기 위해 최선을 다할 것이나 이것이 불가능한 예외적인 상황이 발생할 수 있습니다. 이러한 예외 사항은 파트너와 논의할 것입니다.
3. API 버전은 더 불안정한 API 버전을 위해 지원 중단될 수 없습니다.
   * GA(General Availability) API 버전은 안정성이 떨어진 Alpha 및 Beta 버전을 대체할 수 있습니다.
   * Beta 버전은 이전 Beta 또는 Alpha 버전을 대체할 수 있지만 GA API 버전을 대체하는 데 사용할 수는 없습니다.
   * Alpha 버전은 이전 Alpha 버전을 대체할 수 있지만 Beta 또는 GA 버전을 대체하는 데 사용할 수는 없습니다.
4. 지원 중단 대상으로 표시된 API 버전은 통지일로부터 최대 3개월 동안 지원됩니다. 해당 버전의 지원 및 사용 가능 종료 시점은 별도로 공지합니다. 선호되는 GA API 버전이 도입됨에 따라 Alpha 및 Beta 버전은 더 빨리 지원 중단될 수 있습니다.

* 새 API 버전은 새 버전과 이전 버전을 모두 지원하는 릴리스의 일부로만 도입됩니다.
* 이를 통해 사용자는 이전 버전을 더 이상 사용할 수 없고 폐기되는 기간 내에 최신 버전으로 이전하거나 필요한 경우 롤백할 수 있는 시간을 확보할 수 있습니다.

5. 폐기된 버전을 호출하면 예측할 수 없는 동작이나 잘못된 응답이 발생할 수 있습니다.

## 예외 사항

정책이 모든 가능한 상황을 다룰 수는 없습니다. 이 문서는 살아있는 문서이며 시간이 지나면서 항상 진화할 것입니다. 이 정책에 깔끔하게 맞지 않는 상황이 있거나 이 정책이 심각한 장애물이 되는 경우, 다음 팀과 과제에 대해 논의하세요. <support@citrusad.com> 특정 사례에 대한 최선의 해결책을 찾기 위해 노력하고 있습니다. Epsilon Retail Media 은(는) 가능한 한 사용자에 방해가 되지 않는 안정적인 연동을 제공하기 위해 최선을 다하고 있습니다. 예외 사항은 항상 모든 관련 릴리스 노트에 공지됩니다.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.citrusad.com/retail-media-interface/partner/ko/deprecation-schedule-policy/api-deprecation-policy.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.