어떤 API를 사용합니까?

REST API를 사용하는 경우

REST API는 Salesforce와의 상호 작용을 위해 강력하고 편리하며 단순한 REST 기반 웹 서비스 인터페이스를 제공합니다. 이를 사용하면 쉽게 통합 및 개발할 수 있으며 이는 모바일 응용 프로그램 및 웹 프로젝트에서 사용할 수 있는 훌륭한 기술입니다. 특정 프로젝트의 경우 기타 Salesforce REST API로 REST API를 사용할 수 있습니다. 목록 보기, 작업 및 종속적 선택 목록을 위한 UI 구축을 포함하여 레코드 제작, 판독, 업데이트 및 삭제를 위한 UI를 구축하려면 사용자 인터페이스 API를 사용하고, Lightning의 B2B Commerce, CMS 관리 콘텐츠, Experience Cloud 사이트 또는 Chatter의 UI를 구축하려면 Connect REST API를 사용합니다. 많은 레코드를 처리해야 하는 경우 REST 원리를 기반으로 하며 대량 데이터 집합에 맞게 최적화된 대량 API를 사용할 것을 고려하십시오.

REST API 개발자 가이드를 참조하십시오.

SOAP API를 사용하는 경우

REST API는 Salesforce와의 상호 작용을 위해 강력하고 편리하며 단순한 REST 기반 웹 서비스 인터페이스를 제공합니다. SOAP API를 사용하여 레코드를 작성, 검색, 업데이트 또는 삭제할 수 있습니다. 또한 SOAP API를 사용하여 검색 등을 수행할 수도 있습니다. 웹 서비스를 지원하는 언어로 SOAP API를 사용합니다.

예를 들어, SOAP API를 사용하여 Salesforce와 조직의 ERP 및 재무 시스템을 통합하고, 회사 포털에 실시간 판매 및 지원 정보를 전달하고, 중요한 비즈니스 시스템을 고객 정보로 채울 수도 있습니다.

SOAP API 개발자 가이드를 참조하십시오.

Connect REST API를 사용하는 경우

Connect REST API를 통해 프로그래밍 방식으로 Lightning용 B2B Commerce, CMS 관리 콘텐츠, Experience Cloud 사이트, 파일, 알림, 주제 등에 액세스할 수 있습니다. Connect REST API를 사용하여 특히 모바일 응용 프로그램에서 Chatter 피드, 사용자 및 그룹을 표시합니다.

Connect REST API 개발자 가이드를 참조하십시오.

Apex REST API를 사용하는 경우

Apex REST API는 Apex 클래스 및 메서드를 노출하려는 경우 사용하여 외부 응용 프로그램에서 REST 아키텍처를 통해 사용자의 코드에 액세스하도록 할 수 있습니다. Apex REST API는 인증을 위해 OAuth 2.0 및 세션 ID를 둘 다 지원합니다.

Apex 개발자 가이드: REST 웹 서비스로 Apex 클래스 노출을 참조하십시오.

Apex SOAP API를 사용하는 경우

Apex SOAP API는 Apex 메서드를 SOAP 웹 서비스 API로 노출하려는 경우 사용하여 외부 응용 프로그램에서 SOAP를 통해 사용자의 코드에 액세스하도록 할 수 있습니다.

Apex SOAP API는 인증을 위해 OAuth 2.0 및 세션 ID를 둘 다 지원합니다.

Apex 개발자 가이드: SOAP 웹 서비스로 Apex 메서드 노출 및 SOAP API 개발자 가이드: Apex 관련 호출을 참조하십시오.

Analytics REST API를 사용하는 경우

Analytics REST API를 사용하여 데이터 집합, 렌즈, 대시보드와 같은 CRM Analytics 자산에 프로그래밍 방식으로 액세스할 수 있습니다. Analytics Platform에 가져온 데이터 집합에 액세스하고 쿼리를 전송합니다. 렌즈를 만들고 검색합니다. XMD 정보 액세스 데이터 집합 버전의 목록 검색 CRM Analytics 앱을 만들고 검색합니다. 대시보드 만들기, 업데이트 및 검색 응용 프로그램의 종속성 목록 검색 사용자가 사용할 수 있는 기능 확인 스냅샷에 대해 작업 복제한 데이터 집합 조작

Analytics REST API 개발자 가이드를 참조하십시오.

사용자 인터페이스 API를 사용하는 경우

Salesforce에서 Android, iOS 및 모바일 웹용 Lightning Experience와 Salesforce를 구축하는 데 사용하는 것과 같은 API를 사용하여 기본 모바일 앱 및 사용자 정의 웹 앱을 위한 Salesforce UI를 구축하고, 사용자가 레코드, 목록 보기, 작업 즐겨찾기 등에 대한 작업을 진행할 수 있는 사용자 인터페이스를 구축합니다. 단일 응답으로 데이터 및 메타데이터를 가져오고 응답은 Salesforce 관리자가 조직에 적용한 메타데이터 변경 사항과 일치합니다. 레이아웃, 선택 목록, 필드 수준 보안 또는 공유에 대한 걱정 없이 사용자를 만족시킬 앱을 구축하는 작업에만 전념할 수 있습니다.

사용자 인터페이스 API 개발자 가이드를 참조하십시오.

GraphQL API를 사용하는 경우

단일 요청에서 클라이언트가 필요한 데이터만 반환하여 반응성이 뛰어난 확장 가능한 앱을 구축할 수 있습니다. GraphQL API는 필드 선택, 자원 집계, 스키마 검사를 통해 일반적인 REST API에서 제시한 도전 과제를 극복합니다. 필드 선택 항목을 통해 페이로드의 크기가 줄어들며, 쿼리에 포함된 필드만 다시 전송됩니다. 집계를 통해 클라이언트 및 서버 간의 왕복 이동을 줄이고, 단일 응답 내에서 관련 자원 집합을 반환합니다. 스키마 검사를 사용하면 사용자가 액세스 권한이 있는 유형, 필드, 개체를 볼 수 있습니다.

GraphQL API 개발자 가이드를 참조하십시오.

도구 사용 API를 사용하는 경우

도구 사용 API를 사용하여 Salesforce 메타데이터를 다른 시스템과 통합할 수 있습니다. 메타데이터 유형이 sObject로 표시되므로 하나의 복잡한 형식의 구성 요소에 액세스할 수 있습니다. 이 필드 수준 액세스를 통해 복잡한 메타데이터 유형에 대한 작업 속도를 향상할 수 있습니다. 또한 Force.com 응용 프로그램에 대한 사용자 정의 개발 도구를 구축할 수도 있습니다. 예를 들어, 도구 사용 API를 사용하여 Apex 클래스와 트리거 및 Visualforce 페이지와 구성 요소의 작업 복사본을 관리하고 배포할 수 있습니다. 이를 통해 검사점 또는 힙 덤프 마커를 설정하고, 익명 Apex를 실행하고, 로깅 및 코드 검사 정보에 액세스할 수도 있습니다.

REST와 SOAP가 모두 지원됩니다.

툴링 API를 참조하십시오.

대량 API 2.0을 사용하는 경우

대량 API 2.0을 사용하여 대량 레코드를 비동기식으로 쿼리, queryAll, 삽입, 업데이트, 업서트 또는 삭제할 수 있습니다. 대량 API 2.0은 Salesforce REST 프레임워크에서 설계되었습니다.

2,000개 초과의 레코드를 포함하는 모든 데이터 작업은 대량 프레임워크를 활용하는 비동기 워크플로를 성공적으로 준비, 실행 및 관리하기 위한 대량 API 2.0에 적합한 후보입니다. 2,000개 이하의 레코드를 포함하는 작업에는 REST(예: 복합) 또는 SOAP에서 “bulkified” 동기식 호출을 포함해야 합니다.

대용량 데이터로 작업할 때 가장 쉽게 광범위한 레코드를 생성하고 읽고 업데이트하고 삭제(CRUD)할 수 있습니다. 작업에 sObject 유형이 한 개만 포함되어 있거나 하루에 최대 1TB의 데이터를 추출하는 경우 Salesforce API 중 대량 API 2.0을 선택하십시오.

대량 API 2.0 및 대량 API 개발자 가이드를 참조하십시오.

메타데이터 API를 사용하는 경우

메타데이터 API를 사용하여 조직에 대한 사용자 정의를 검색, 배포, 만들기, 업데이트 또는 삭제합니다. 가장 일반적으로 Sandbox 또는 테스트 조직의 변경 사항을 프로덕션 환경으로 마이그레이션하는 데 사용됩니다. 메타데이터 API는 사용자 정의를 관리하고 데이터 자체가 아닌 메타데이터 모델을 관리할 수 있는 도구를 만들기 위해 작성되었습니다.

메타데이터 API의 기능에 가장 쉽게 액세스하는 방법은 Visual Studio 코드용 Salesforce 확장 또는 Salesforce CLI를 사용하는 것입니다. 두 도구가 모두 메타데이터 API의 맨 위에 작성되며 표준 도구를 사용하여 메타데이터 API 작업을 간소화합니다.

• Visual Studio 코드용 Salesforce Extension은 가볍고 확장 가능한 VS 코드 편집기에서 Salesforce 플랫폼을 개발하기 위한 도구가 포함되어 있습니다. 해당 도구는 개발자 조직(스크래치 조직, Sandbox 및 DE 조직), Apex, Aura 구성 요소 및 Visualforce 작업을 위한 기능을 제공합니다.
• Salesforce CLI는 로컬 디렉터리와 Salesforce 조직 간에 메타데이터를 이동하기 위해 스크립팅 또는 명령줄을 사용하는 경우 적합합니다.

메타데이터 API 개발자 가이드를 참조하십시오.

Pub/Sub API를 사용하는 경우

Pub/Sub API를 사용하여 외부 시스템과 이벤트를 통합할 수 있습니다. 이벤트 스트림은 변경 데이터 캡처를 거쳐 Salesforce 레코드의 플랫폼 이벤트나 변경 사항을 통한 사용자 정의 페이로드를 기반으로 합니다. Salesforce에서 Apex 트리거, 프로세스 빌더, Flow Builder를 사용하여 이벤트를 게시하고 구독할 수 있습니다.

Pub/Sub API는 Salesforce와의 대규모 양방향 이벤트 통합을 위해 구축되었습니다. Pub/Sub API를 사용하여 Apache Avro 형식으로 이진 이벤트 메시지를 효율적으로 게시하고 구독합니다. Pub/Sub API는 gRPC 및 HTTP/2를 기반으로 하며, 가져오기 기반 모델을 사용하므로 구독 플로를 제어할 수 있습니다. Pub/Sub API를 사용하면 gRPC가 지원하는 11가지 프로그래밍 언어 중 하나를 사용할 수 있습니다.

필요를 충족하는 스트리밍 이벤트 유형을 사용하십시오.

• 데이터 수집 변경 이벤트: 변경된 필드 전체에 대한 Salesforce 레코드의 변경 사항을 수신합니다. 데이터 수집 변경은 PushTopic 이벤트보다 표준화된 개체를 지원하며, 변경 사항 정보가 포함된 머리글 필드 등 추가 기능을 제공합니다.
• 플랫폼 이벤트: 사전 정의된 스키마로 사용자 정의 페이로드를 게시하고 수신합니다. 데이터는 주문 정보와 같은 비즈니스 데이터를 비롯해 사용자가 정의한 모든 항목일 수 있습니다. 플랫폼 이벤트를 정의하여 전송할 데이터를 지정하고 플랫폼 이벤트 채널을 구독하여 알림을 수신하십시오.
• 레거시 이벤트: PushTopic 및 일반 이벤트: PushTopic 및 일반 이벤트는 1세대 이벤트입니다. 지원이 제한되며 더 이상 새로운 기능으로 업데이트되지 않습니다. PushTopic 이벤트 대신 변경 데이터 캡처 이벤트를 그리고 일반 이벤트 대신 플랫폼 이벤트를 사용하는 것이 좋습니다.

Pub/Sub API 문서를 참조하십시오.