Salesforce Platform API 버전 21.0~30.0 사용 중지

최초 게시 날짜 - 2020년 10월 20일

업데이트 날짜 - 2024년 5월 4일
 

SOAP, REST, Bulk API 버전 21~30 상태는 어떻습니까?

• 현재: 해당 API 버전은 사용이 중단되었으며(Summer '22 릴리스부터) 더 이상 지원되지 않습니다. 해당 버전을 사용할 수는 있지만 문제가 발생하여 Salesforce 지원 팀에 사례를 기록하려는 경우 먼저 API 버전을 업데이트해야 합니다. 향후 레거시 API 버전에 대한 문제 해결이나 버그 수정은 이루어지지 않습니다.

• 향후 계획: Summer '25 릴리스 – 해당 API 버전은 사용 중지됩니다. 해당 버전을 사용하는 응용 프로그램이 정상 작동하지 않습니다. 이 경우 호출이 실패하고, 요청된 끝점을 찾을 수 없으며 플랫폼에 의해 처리될 수 없다는 오류가 응답으로 제공됩니다. 다음은 관련 오류입니다.

  • REST API에서 반환되는 값 - 410: GONE.

  • SOAP API에서 반환되는 값 - 500: UNSUPPORTED_API_VERSION.

  • Bulk API에서 반환되는 값 - 400: InvalidVersion.

참고: API 버전 7.0~20.0은 Summer '22 릴리스에서 이미 사용 중지되어 더 이상 사용할 수 없습니다.

해당 API 버전을 사용 중지하는 이유는 무엇입니까?
Salesforce는 응용 프로그램을 통해 사용자 정의 기능을 구축할 경우 전반적인 Salesforce 환경을 향상하기 위해 최신 API 버전 개선에 개발 노력을 집중하고 있습니다. 장기적인 관점에서 Spring '14 릴리스를 통해 API 버전 30이 소개되었습니다.

이 API 버전의 사용 중지가 미치는 영향은 무엇입니까?
이번 사용 중지는 버전 21.0~30.0 SOAP, REST 또는 Bulk API에 대한 요청을 실행하는 일체의 코드, 패키지, 응용 프로그램 또는 통합에 영향을 미칩니다.  

참고: 이번 사용 중지는 다음에는 영향을 미치지 않습니다.

• Apex 클래스, Apex 트리거, Visualforce 페이지, 플로, 프로세스 빌더의 API 버전

• 추가 설정이 적용되지 않은 B2B Classic/Visualforce 제품

• 관리형 패키지에 포함된 버전 지정된 메타데이터 구성 요소

• 사용자 정의 Apex REST 및 SOAP 웹 서비스(사용자 정의 Apex 웹 서비스는 Apex 클래스 메서드를 공개 API로 호출할 수 있도록 만드는 방법입니다. Apex 웹 서비스에서 Apex 웹 서비스에 대해 자세히 알아볼 수 있습니다.)

어떤 조치를 취해야 합니까?

1. 레거시 API 버전을 사용하는 조직의 모든 구성 요소/응용 프로그램을 식별합니다.

2. 해당 구성 요소/응용 프로그램을 업데이트합니다. Summer '25 릴리스 전에 현재 지원되는 API 버전으로 작동하도록 응용 프로그램을 수정하거나 업그레이드해야 합니다. Salesforce는 고급 성능 및 개선된 보안과 성능을 사용할 수 있으므로 새 버전으로 이동할 것을 적극 권장합니다.

아래 표에서 영향이 미치는 일반적인 위치 및 각각에 대해 취할 조치를 확인하십시오.

내 응용 프로그램에서 레거시 API 버전을 사용하고 있는지 확인하는 방법은 무엇입니까?

현재 사용 중인 응용 프로그램의 개발자에게 문의하여 API 버전을 판단하십시오.

다음의 두 가지 방법 중 하나를 사용하여 Salesforce의 SOAP, REST, Bulk API 활동을 보고하는 무료 API 총 사용량 EventLogFile에서 API 이벤트를 검토할 수도 있습니다.

1. 첫 번째 방법은 Summer '24 릴리스에 포함된 새 이벤트 로그 탐색기를 사용하는 것입니다.  이 방법을 사용하면 조직의 API 총 사용량 이벤트 로그 파일을 탐색할 수 있으며, CSV 파일로 다운로드하여 개별 API 이벤트를 확인할 수 있습니다.  

설정에서 보안 → 이벤트 모니터링 → 이벤트 로그 탐색기로 이동합니다.  여기에서 최근 24시간(또는 이벤트 모니터링이 활성화된 경우 지난 30일) 동안의 이벤트 로그 파일을 볼 수 있습니다.  그러면 개별 이벤트 로그 파일을 CSV 파일로 다운로드하여 파일에 적힌 API 이벤트를 확인할 수 있습니다.

2. 또는 두 번째 방법으로, Salesforce CLI와 같은 클라이언트를 사용하여 EventLogFile 개체에 대해 SOQL 쿼리를 실행하고 최근 24시간(또는 이벤트 모니터링이 활성화된 경우 30일) 동안의 이벤트 로그 파일을 확보합니다.

sf data query -q "SELECT Id, LogFile, EventType, CreatedDate FROM EventLogFile WHERE EventType IN ('ApiTotalUsage')" -o <your-username>

각 결과에 대해 쿼리 결과의 끝점으로 REST API 요청을 수행하여 해당 이벤트 로그 파일*의 이벤트 로그 데이터를 가져옵니다.

/services/data/v58.0/sobjects/EventLogFile/0AT3i000005vXpWGAU/LogFile

응답 본문을 응용 프로그램에 붙여넣으면 이벤트 로그 데이터를 .CSV 파일로 검사할 수 있습니다.

3. 각 .CSV 파일을 검토하여 요청이 API 버전 30 이하를 사용하여 끝점으로 전송하고 있는지 확인합니다.

API_VERSION이 30 이하인 모든 API 총 사용량 이벤트(ApiTotalUsage EventType)를 검토합니다.**

4. 버전 30.0 이하를 사용하는 모든 통합 또는 클라이언트의 경우 이벤트 로그 데이터의 주요 필드에서 제공하는 힌트를 참고하여 레거시 API 호출의 소스를 식별합니다.

CLIENT_NAME, CONNECTED_APP_ID, ENTITY_NAME, USER_ID

이벤트 모니터링에 대한 자세한 내용은 이벤트 모니터링 Trailhead 모듈을 확인하십시오.

*REST API 요청 수행과 관련된 소개 정보는 REST API 사용 Trailhead를 참조하십시오.

**"API 총 사용량" 이벤트 유형은 SOAP, Bulk, REST API의 관련 요청 정보와 버전 정보를 통합합니다. 여기에서 이벤트 정의 세부 사항을 확인하십시오. API 지원 조직은 API Total Usage 이벤트 로그 파일에 무료로 액세스할 수 있으며, 데이터는 1일간 보존됩니다. 이벤트 모니터링이 설정된 경우 이 로그 파일과 다른 모든 이벤트 로그 파일 유형에 액세스할 수 있으며, 데이터는 30일간 보존됩니다.

다음을 수행하여 Bulk API 요청 또는 SOAP API 로그인을 찾을 수도 있습니다.

• 대량 API 요청 찾기: 대량 API의 경우 설정 내 "대량 데이터 로드 작업" 페이지로 이동하여 각 "Bulk V1" 작업의 세부 사항을 봅니다. 이번 API 사용 중지는 "API 버전" 필드의 값이 30.0 이하인 작업에 영향을 미칩니다.

• SOAP API 로그인 찾기: SOAP login() operation의 경우 설정의 "로그인 내역"로 이동하여 API 유형이 "SOAP Enterprise" 또는 "SOAP Partner"인 항목을 검토하십시오. 또는 SOQL을 통해 LoginHistory sObject를 쿼리할 수 있습니다. "API 버전" 필드의 값이 30.0 이하인 로그인 항목은 이번 사용 중지의 영향을 받습니다.

참고: 파트너는 패키지 사용 로그에서 사용 중단된 API 소비에 대한 인사이트를 확인할 수 있습니다.

자세한 내용을 어떻게 확인할 수 있습니까?

지원되는 최신 API 버전은 Salesforce 개발자 사이트에서 확인하십시오.

API 및 아웃바운드 Messaging:

• Platform API 기본 사항(Trailhead)

• SOAP API 소개(개발자 가이드)

• 아웃바운드 Messaging 이해(개발자 가이드)

• 대량 API(개발자 가이드)

• REST API 소개(개발자 가이드)

  • "REST"에서는 /services/data/vXX.Y/ 및 /services/metadata/vXX.Y/ 끝점 URI를 갖는 모든 API를 다룹니다. 여기서 XX.Y는 API 버전입니다. 여기에는 sObject 및 레코드와 작동하는 "표준" Salesforce Platform REST API와 다음 리소스가 포함됩니다.

    • Metadata API 개발자

    • Tooling API

    • Chatter/Connect API

    • Query and Query All API

    • Search API

    • Limits API

    • 로그인 API ("ID")

• • • GET /services/data/v30.0 또는 GET /services/metadata/v30.0에 대한 REST 요청의 결과를 살펴보면 v30.0 이하 끝점이 사용 중지될 경우 영향을 받는 최상위 수준 자원을 확인할 수 있습니다.

이번 레거시 API 사용 중지에 대한 자세한 정보는 레거시 API 사용 중지 계획에 대한 중요 업데이트를 참조하십시오.

관리자를 위한 API 버전 설명은 Why API Versions Matter with Kris Harrison 팟캐스트를 청취하십시오(수년 전에 제작되었지만 핵심 정보는 같습니다).

아직 도움이 필요한 경우 어떻게 해야 합니까?

• 위에 적힌 자원을 살펴봅니다.

• Trailblazer Community에 게시합니다.

• Salesforce 도움말을 통해 Salesforce 지원 팀에 사례를 전달합니다. 지원 팀이 최대한 효율적으로 도움을 제공할 수 있도록 지금까지 시도한 내용 및 문제가 있는 지점을 기억해 주십시오. **지원 팀은 조직의 레거시 API를 업데이트할 수 없습니다.

모든 현재 및 지난 사용 중지 정보를 확인하려면 Salesforce 제품 및 기능 사용 중지를 참조하십시오. Salesforce에서 제품 및 기능을 사용 중지하기 위한 접근 방식에 대해 자세히 알아보려면 제품 및 기능 사용 중지 철학을 읽어보십시오.