Lightning Platform API 레거시 버전 사용 중지

변경 사항은 무엇입니까?

Summer '21 릴리스 이후 다음 Lightning Platform API 레거시 버전의 사용이 중단되며, 더 이상 Salesforce에서 지원되지 않습니다.

• SOAP: 7.0, 8.0, 9.0, 10.0, 11.0, 12.0, 13.0, 14.0, 15.0, 16.0, 17.0, 18.0, 19.0, 20.0

• REST: v20.0

• Bulk: 16.0, 17.0, 18.0, 19.0, 20.0

고객은 레거시 API 버전이 만료되는 Summer '21 릴리스까지 계속해서 해당 레거시 버전을 사용할 수 있습니다. 레거시 버전이 만료되면 영향 받는 API 버전을 소비하는 응용 프로그램에서 요청에 실패하고 요청 끝점이 비활성화되었다고 적힌 오류가 나타나는 중단 현상을 경험하게 됩니다. 

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

고객은 Summer '21 릴리스 전에 응용 프로그램을 대부분의 현재 사용 가능한 API 버전과 호환되도록 수정하거나 업그레이드해야만 만료된 버전을 참조하는 소프트웨어로 인한 중단을 방지할 수 있습니다. 새로운 API 버전으로 이동하면 고급 성능 및 개선된 보안과 성능을 사용할 수 있습니다.

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

만료되는 API 버전을 사용 중인 응용 프로그램을 확인하려면 조직에서 사용 중인 응용 프로그램 개발자에게 API 버전을 문의하십시오. 
 

응용 프로그램 개발자에게 문의할 수 없는 경우, 다음 단계를 수행하여 Salesforce 조직의 SOAP 및 REST API 활동을 보고하는 이벤트 로그를 검토할 수 있습니다.

1. Salesforce CLI 등 도구를 사용하여 EventLogFile 개체에 대한 SOQL 쿼리를 실행하면 지난 24시간 동안 취해진 모든 활동 로그를 확인할 수 있습니다.

   1. sfdx force:data:soql:query -q "SELECT LogFile, EventType, CreatedDate FROM EventLogFile WHERE EventType IN ('API', 'RestApi')" -u <your-username>

2. 각 결과에서 끝점으로 REST 요청을 수행하여 데이터를 가져와 .CSV 파일에 복사합니다.

   1. 예: /services/data/v46.0/sobjects/EventLogFile/0AT3i000005vXpWGAU/LogFile

   2. 응답 내용을 Excel 등 응용 프로그램에 붙여 넣으면 이벤트 로그 데이터를 .CSV 파일로 더욱 쉽게 볼 수 있습니다.

3. 각 .CSV 파일을 검토하고 요청이 API 버전 20 이하에서 끝점으로 전송되었는지 판단합니다.

   1. SOAP/API EventType - "E" 또는 "P"의 API_TYPE 레코드에 대한 API_VERSION 열에서 값을 검토합니다.

   2. REST/RestApi EventType - URI 열에서 값을 검토하고 경로에서 "/v20.0" 이하로 나타난 끝점을 적습니다.

4. 버전 20 이하를 소비하는 모든 통합은 API 만료로 영향을 받게 됩니다.

자세한 정보는 이벤트 로그 파일을 다운로드 및 가상화하는 방법 Trailhead 모듈을 확인하십시오. 

대량 API의 경우 설정 내 "대량 데이터 로드 작업" 페이지로 이동하여 각 "Bulk V1" 작업의 세부 사항을 봅니다. "API Version" 필드 내 20.0 이하 값이 표시된 작업은 API 만료에 영향을 받습니다. 

이 제품이 만료되는 이유는 무엇입니까?

Salesforce는 응용 프로그램을 통해 사용자 정의 기능을 구축할 경우 전반적인 Salesforce 환경을 향상하기 위해 최신 API 버전 개선에 개발 노력을 집중하고 있습니다. 

자세한 정보는 어떻게 확인할 수 있습니까?

최신 SOAP API 버전이 지원하는 기능에 대한 추가 정보는 Salesforce 개발자 사이트에 방문하여 다음 문서를 참조하십시오.

• SOAP API 개발자 가이드 소개

• Lightning Platform REST API 소개

• 대량 API 소개

추가 질문은 도움말 및 교육 포털을 통해 고객 지원 부서에 문의할 수 있습니다.