Klaviyo API 시작하기

학습 내용

API 호출의 기본 개념과 Klaviyo API가 비즈니스에 어떤 이점을 제공할 수 있는지 알아보세요.  이 가이드에서는 REST API, HTTP 메서드, 개발자 도구를 알아보고 Klaviyo API를 테스트할 수 있도록 준비해요. 첫 API 호출은 처음부터 끝까지 10분이면 완료할 수 있어요. 이미 API 호출에 익숙하고 API를 테스트할 준비가 되었다면 Postman 컬렉션을 사용하는 방법에 대한 가이드를 따라 주세요.

REST API란 무엇인가요?

REST API는 Representational State Transfer와 Application Programming Interface를 의미하는 약어예요. 이 용어들은 소프트웨어가 다른 소프트웨어와 통신하고 서로 간에 정보를 전달할 수 있도록 하는 구조화된 요청으로 더 간단히 이해할 수 있어요. API 호출을 하면 정보가 저장된 서버에 요청을 제출하게 되며, 서버는 요청한 데이터가 포함된 JSON(또는 JavaScript Object Notation) 형식의 응답을 반환해요.

더 쉽게 말해, REST API를 사용하면 Klaviyo에 저장된 데이터를 요청하고, 사람이 읽을 수 있고 컴퓨터도 읽을 수 있는 형식으로 해당 데이터를 돌려받을 수 있어요.

표준 API 호출은 몇 초 안에 이루어져요. 백그라운드에서 통화는 다음과 같이 진행돼요:

1. 인터넷을 통해 API로 구조화된 데이터 요청을 보내세요. 요청은 HTTP를 통해 전송되며, HTTP는 인터넷이 대부분 이를 기반으로 구축된 기본 네트워크 요청 유형이에요.
2. API는 요청을 수신하고 처리한 다음, Klaviyo 데이터베이스에서 요청된 정보를 가져옵니다.
3. 그러면 API는 JSON 구조화 형식을 사용해 클라이언트 애플리케이션에 응답합니다.
4. 클라이언트 애플리케이션에서 JSON 응답을 받게 됩니다.

이 지식은 데이터 전송이 어떻게 작동하는지 이해하는 데 도움이 되지만, API 호출을 시작하고 Klaviyo API가 제공하는 가치를 얻는 데 필수는 아니에요. 첫 번째 API 호출을 시작하는 데 필요한 모든 내용은 다음 섹션에서 다룰게요.

HTTP 방식

HTTP 메서드는 요청을 보내는 데 사용하는 “동사”예요. 이 가이드에서는 2가지 HTTP 메서드 인 GET과 POST를 다룰게요. 

GET

GET 요청은 “읽기” 요청으로 이해하면 가장 쉬워요. GET 요청은 API 엔드포인트에서 정보를 가져와 JSON 형식의 응답으로 반환해요. 이 요청은 데이터 읽기만 허용하므로, 이 방법으로는 데이터를 수정하거나 덮어쓸 수 없어 가장 안전한 요청 유형이에요.

POST

POST 요청은 간단히 “쓰기” 요청으로 이해할 수 있어요. POST를 사용하면 새 리소스를 생성하거나 추가할 수 있어요. 예를 들어 List API에 대한 POST 요청은 계정에 새 리스트를 생성하는 데 사용할 수 있고, GET 요청은 사용 가능한 모든 리스트를 가져오는 데 사용할 수 있어요. 데이터를 게시할 때는 Klaviyo가 요청을 완료할 수 있는 시점에 따라 응답이 달라질 수 있다는 점에 유의하세요.

필요한 도구

API는 워크플로우에 다양한 유연성을 제공하며, 원하는 결과를 얻기 위해 특정 클라이언트 애플리케이션이나 언어 라이브러리를 사용할 필요가 없어요. API 호출은 HTTP 요청을 사용해 이루어지므로, 거의 모든 프로그래밍 언어에서 기본 기능으로 또는 널리 사용 가능한 언어 라이브러리를 통해 이러한 유형의 요청을 보낼 수 있어요. 또한 사용하는 기기와 운영 체제에 따라 Apple의 터미널 또는 Windows 명령줄 같은 기본 애플리케이션을 사용해 클라이언트 측 API 호출을 수행할 수 있어요. 하지만 이러한 애플리케이션을 사용하려면 명령줄 인터페이스에 대한 사전 지식이 필요해요.

Postman이라는 무료 웹 및 데스크톱 애플리케이션을 사용해요. Postman에는 엔드포인트, 매개변수, 인증을 유용한 사용자 인터페이스에 입력해 API 요청을 설정하고 전송하기 쉽게 해주는 다양한 기능이 있어요.

Klaviyo API 테스트

Klaviyo의 API는 다른 플랫폼이나 서버에서 Klaviyo 계정으로 데이터를 전송하거나, Klaviyo 계정 내의 정보를 조회하는 데 유용해요. 이제 API가 작동하는 방식을 이해했으니, 비즈니스 사용 사례에 맞게 Klaviyo의 API를 테스트하는 작업을 시작할 수 있어요. Klaviyo에서 사용 가능한 API의 전체 목록을 확인하려면 API 참조 문서를 확인해 주세요. Postman 컬렉션 사용 방법 가이드 를 따라 첫 Klaviyo API 호출을 만들어 보세요.

추가 자료

개발자 포털 리소스

Klaviyo의 개발자 포털 에는 API를 최대한 활용할 수 있도록 도와주는 API 가이드 및 참조 문서가 포함되어 있어요. 시작하려면 아래 리소스를 확인하세요:

• Klaviyo API 참조 문서
• Javascript API 시작하기
• API 기반 트랜잭션 이벤트 설정

Klaviyo 개발자 교육 코스

Klaviyo 아카데미 에서는 Klaviyo API로 빌드를 시작하는 데 도움이 되는 개발자 교육 코스를 제공해요. 아래의 교육 코스를 확인해 보세요:

• 마케터를 위한 API 기본 사항
• Klaviyo 개발자 인증서
• 일반적인 API 용어 정의