1. 가용한 엔드포인트(Available Endpoints)

에어브릿지는 아래의 리소스들에 대하여 API를 제공합니다.

Name	Resource	Description
Tracking Link	https://api.airbridge.io/tracking-link	트래킹링크를 생성하고, 가져오고, 삭제할 수 있습니다.
Actuals Report	https://api.airbridge.io/reports	Actuals 리포트를 쿼리하여 통계를 가져오거나, 리포트 설정을 저장할 수 있습니다.
Raw Data Export	https://api.airbridge.io/log-export	웹/앱 Raw Data를 요청하고, CSV 파일을 다운로드할 수 있는 링크를 받을 수 있습니다.
Attribution Result	https://api.airbridge.io/attribution-result	특정 Device의 어트리뷰션 결과를 확인할 수 있습니다.

2. 필수 인증 파라미터 (Authorization)

(1) : 앱 이름 (Unique ID)

모든 API 호출에는 앱 이름 (Unique ID / App Name)가 필수적으로 들어갑니다. 앱 이름은 앱을 생성한 생성자가 지정하게 되며, 한 번 생성되면 수정할 수 없습니다.

앱 이름은 에어브릿지 대시보드의 아래의 경로에서 확인할 수 있으며, 상단의 이미지를 참조해주십시오.

Airbridge Dashboard > Settings > Tokens

(2) : API 토큰

보안 인증

에어브릿지 API의 보안 인증은 HTTP Request Header에 있는 Authorization Key에 API 토큰을 넣는 형식을 따르고 있습니다. 에어브릿지는 매번 API가 호출될 시 해당 토큰의 진실성 여부를 체크합니다.

호출의 예시는 아래와 같습니다.

curl -H "Authorization: Bearer {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의 동작이 중지되므로, 재생성 여부를 신중하게 결정해야 합니다.