Salesforce 주요 API 정리: REST, SOAP, Bulk, Composite, GraphQL

클로비스
29분 전
2분 분량

안녕하세요, 클로비스입니다.

Salesforce는 외부 시스템과의 연동을 위해 용도와 목적에 따라 다양한 API를 제공합니다. 대표적으로 REST API, Bulk API, Composite API 등이 있으며, 각 API는 처리 방식과 활용 시나리오가 명확히 구분됩니다.

이 포스팅에서는 실제 프로젝트에서 자주 사용되는 Salesforce의 주요 API 5종을 소개해 드리겠습니다.

주요 Salesforce API 비교

구분	주요 특징	적합한 시나리오
REST API	실시간, 간결함, 표준화	외부 시스템 실시간 연동
SOAP API	정형 데이터 기반 엄격한 규격 및 보안	레거시 시스템 엔터프라이즈 통합
Bulk API 2.0	대량 데이터 처리 최적화	데이터이관, 배치 작업, 동기화
Composite API	여러 요청을 하나로 통합	UI/모바일 성능 최적화
GraphQL API	필요한 데이터만 선택 조회	프론트엔드 최적화

1. REST API

REST API는 HTTP 기반으로 Salesforce 데이터에 접근하는 가장 기본적인 인터페이스 입니다. 외부 시스템이 Salesforce 개체(Account, Opportunity 등)에 대해 조회(Create/Read), 수정(Update), 삭제(Delete) 작업을 수행할 수 있습니다.

특징: CRUD(Create, Read, Update, Delete) 작업을 수행하며, 대부분의 개발 언어와 플랫폼에서 쉽게 연동이 가능합니다.
Key Point: 실시간 응답이 필요한 모바일 앱이나 외부 웹 서비스 연동에 최적입니다.
주의사항: 호출당 API Call Limit이 소모되므로, 반복적인 대량 호출 시 설계를 유의해야 합니다.

2. SOAP API

SOAP API는 XML 기반의 메시지 구조와 WSDL(Web Service Definition Language)을 사용하는 계약 중심의 API 입니다.

특징: 데이터 타입이 엄격하고 보안기능이 강력합니다.
Key Point: 신규 프로젝트 보다는 과거에 구축된 레거시 시스템과의 연동이나 유지보수에 주로 사용됩니다.

3. Bulk API 2.0

Bulk API는 Salesforce의 대량 데이터 처리 전용 API로 수만 건 이상의 데이터를 처리할 수 있는 API입니다.

특징: 비동기 방식으로 데이터를 Job 단위로 묶어서 처리합니다.
Key Point: 수백만 건의 데이터 마이그레이션이나 ERP-Salesforce 간의 대규모 정기 동기화에 사용됩니다.
장점: 일반 REST API보다 Limit 관리에 유리합니다.

4. Composite API

UI나 모바일 화면에서는 세일즈포스의 계정, 기회, 연락처 등 여러 개체의 데이터 요청이 동시에 이루어 질 수 있는데, Composite API는 여러개의 요청을 하나의 호출로 묶어서 처리할 수 있습니다.

특징: 여러 유형의 REST API 요청을 하나의 요청으로 묶어서 호출 할 수 있습니다. 예를 들어, '계정(Account)'을 생성하고 그 결과 ID를 받아 바로 '연락처(Contact)'를 생성하는 과정을 한 번의 호출로 수행할 수 있습니다.
Key Point: API Call 횟수를 줄여주며, 모바일 환경에서 화면 로딩 및 처리 속도를 개선할 때 유용합니다.

5. GraphQL API

GraphQL API는 클라이언트가 "어떤 필드가 필요한지"를 직접 정의해서 요청하는 API입니다. REST처럼 서버가 정해준 응답 구조를 그대로 받지 않고, 필요한 데이터만 선택적으로 조회할 수 있습니다.

특징: REST API의 단점인 'Over-fetching(불필요한 데이터까지 받는 것)'을 해결합니다.
Key Point: 복잡한 화면 구성에서 필요한 필드만 선택하여 사용하며, 특히 프론트엔드 성능 최적화에 강력한 도구입니다.

Salesforce API의 특징들을 고려해서 다음과 같이 요약할 수 있습니다.

실시간성이 중요하고 간단한 연동이라면? 👉 REST API
수만 건 이상의 데이터를 한 번에 부어야 한다면? 👉 Bulk API 2.0
여러 객체를 동시에 다루며 API 호출 횟수를 아끼고 싶다면? 👉 Composite API
프론트엔드 성능과 데이터 효율이 최우선이라면? 👉 GraphQL API

Salesforce API에 대한 더 자세한 내용은 Salesforce Help 문서를 통해 확인하실 수 있습니다.

관련 Help 문서 바로가기

안내드린 내용 이외에도 문의사항이 있다면, 아래 폼을 통해 언제든지 클로비스에 문의 부탁드립니다.

클로비스의 월간 뉴스레터를 구독하시면,

그 어디에서도 볼 수 없는 클로비스만의 유용한 🎉Salesforce 사용 꿀팁🎉과 함께 클로비스의 새로운 소식을 메일로 받아보실 수 있습니다! 고객 여러분들의 많은 구독 부탁드립니다!

☞구독하기