인증
키 하나로 인증합니다. 모든 요청 헤더에 X-API-Key 를 넣습니다.
X-API-Key: da_live_...키가 정하는 것
키는 구독에 묶여 있습니다. 그래서 같은 경로를 불러도 구독에 따라 결과가 다를 수 있습니다 — 열린 엔드포인트, 가려지는 항목, 적용되는 금융 상품과 마진이 구독 설정을 따릅니다.
내 구독이 무엇을 쓸 수 있는지는 직접 조회할 수 있습니다.
| 경로 | 무엇을 알려주나 |
|---|---|
GET /api/v1/my/endpoints | 내 구독에 열린 경로 |
GET /api/v1/my/quota | 한도와 남은 호출 수 |
GET /api/v1/my/usage | 기간별 사용량 |
키를 어디에 두나
키는 서버 환경변수에만 둡니다. 저장소에 커밋하거나 브라우저·앱 코드에 넣으면 그대로 새어 나갑니다. 노출된 키는 값을 고치는 게 아니라 다시 발급받아야 합니다.
클라이언트에서 견적을 보여줘야 하면, 여러분의 서버가 이 API 를 부르고 그 결과만 내려주세요.
오류
| 상태 | 뜻 | 할 일 |
|---|---|---|
401 | 키가 없거나 그런 키가 없습니다 | 헤더 이름과 값을 확인하세요. 붙여넣을 때 줄바꿈이 섞이는 경우가 가장 흔합니다 |
403 | 키는 맞지만 그 경로가 구독에 없습니다 | /api/v1/my/endpoints 로 열린 경로를 확인하세요 |
400 | 입력이 잘못됐습니다 | 응답 본문이 무엇이 잘못됐는지 말해줍니다. 이 차량의 것이 아닌 키를 보내면 선택 가능한 목록을 함께 돌려줍니다 |
429 | 한도를 넘었습니다 | /api/v1/my/quota 로 남은 양을 확인하세요 |