에어브릿지 API를 사용하여 대시보드에서 수행할 수 있는 다양한 작업을 프로그래매틱하게 수행할 수 있습니다.
1. 가용한 엔드포인트(Available Endpoints)
에어브릿지는 아래의 리소스들에 대하여 API를 제공합니다.
Name | Resource | Description |
|---|---|---|
Tracking Link | 트래킹링크를 생성하고, 가져오고, 삭제할 수 있습니다. | |
Actuals Report | Actuals 리포트를 쿼리하여 통계를 가져오거나, 리포트 설정을 저장할 수 있습니다. | |
Raw Data Export | 웹/앱 Raw Data를 요청하고, CSV 파일을 다운로드할 수 있는 링크를 받을 수 있습니다. | |
Attribution Result | 특정 Device의 어트리뷰션 결과를 확인할 수 있습니다. | |
Identity Resolution | 사용자의 글로벌 Identity를 확인할 수 있습니다. |
2. 필수 인증 파라미터 (Authorization)
(1) : 앱 이름 (Unique ID)
앱 이름, API 토큰 확인 방법
모든 API 호출에는 앱 이름 (Unique ID / App Name)가 필수적으로 들어갑니다. 앱 이름은 앱을 생성한 생성자가 지정하게 되며, 한 번 생성되면 수정할 수 없습니다.
앱 이름은 에어브릿지 대시보드의 아래의 경로에서 확인할 수 있으며, 상단의 이미지를 참조해주십시오.
Airbridge Dashboard > Settings > Tokens
(2) : API 토큰
보안 인증
에어브릿지 API의 보안 인증은 HTTP Request Header에 있는 Authorization Key에 API 토큰을 넣는 형식을 따르고 있습니다. 에어브릿지는 매번 API가 호출될 시 해당 토큰의 진실성 여부를 체크합니다.
호출의 예시는 아래와 같습니다.
curl -H "Authorization: AIRBRIDGE-API-KEY {API-TOKEN}" https://api.airbridge.io
토큰의 종류
에어브릿지는 총 2가지 종류의 API 토큰을 가지고 있습니다.
- API 토큰
- 트래킹 링크 API 토큰
일반 API 토큰이 모든 API 호출에 사용되는 반면, 트래킹 링크 API 토큰은 트래킹 링크를 생성할 시에만 사용할 수 있습니다. 트래킹 링크 API 토큰이 별도로 존재하는 이유는 해당 API 토큰이 클라이언트 로직 상에 포함되어야 할 수도 있고, 혹은 외부 대행사 등에 전달되어야 할 필요도 있기 때문입니다.
토큰의 발급 및 확인
API 토큰은 앱 생성 시 자동으로 발급됩니다.
API 토큰은 에어브릿지 대시보드의 아래의 경로에서 확인할 수 있으며, 상단의 이미지를 참조해주십시오.
Airbridge Dashboard > Settings > Tokens
토큰의 재생성
API 토큰을 에어브릿지 대시보드의 아래의 경로에서 재성성할 수 있습니다.
Airbridge Dashboard > Settings > Tokens
그러나 API 토큰 재생성 시 기존 토큰이 폐기되어, 기존 토큰을 사용하고 있는 모든 API의 동작이 중지되므로, 재생성 여부를 신중하게 결정해야 합니다.