ATRACE API 개요
타이어 점검 리포트를 만드는 두 API인 ATRACE Report API와 AI Engine API를 소개합니다.
ATRACE는 타이어 이미지를 분석해 점검 리포트를 만들고 공유하는 플랫폼입니다. 파트너는 자사앱에서 촬영한 타이어 사진을 ATRACE에 보내고, 완성된 리포트를 받아 고객에게 전달합니다.
ATRACE는 목적이 다른 두 API를 제공합니다. 처음 연동한다면 이 차이를 먼저 알아야 합니다.
ATRACE Report API
대부분의 파트너가 쓰는 고수준 API입니다. POST /reports 한 번으로 리포트 생성·분석·공유를 자동 처리합니다.
AI Engine API
저수준 분석 API입니다. 자체 리포트 시스템을 직접 만드는 고객용으로, 이미지를 받아 분석값을 돌려줍니다.
읽는 순서
- ATRACE Report API와 AI Engine API — 두 API의 차이와 선택 기준.
- 시작하기 — 인증, 호스트, 첫 호출.
- 리포트 생성 흐름 — 다이어그램으로 보는 전체 과정.
전체 구조
대부분의 파트너는 ATRACE Report API만 호출하면 됩니다. AI 추론 서비스 호출은 플랫폼이 대신 처리합니다.
두 API의 인증 방식은 동일합니다. 발급받은 하나의 API Key를 Authorization: Bearer <API Key> 헤더로 그대로 보내면 됩니다. 스코프만 다릅니다 — ATRACE Report API는 report:*, AI Engine API는 ai:*.
계약 안정성 보장
이 문서의 API 계약은 고정되어 있습니다. 필드 추가는 하되, 기존 필드의 제거나 의미 변경은 다음 메이저 버전까지 하지 않습니다.