API Key와 Access Token의 역할, 전달 방식, 오류 응답을 설명합니다.
Deeply API는 API Key와 Access Token을 함께 사용합니다.
두 토큰의 역할이 다르므로 구분해서 사용하는 것이 중요합니다.
API Key: Access Token 발급에만 사용하는 장기 자격 증명Access Token: 일반 API 요청에 사용하는 Bearer 토큰일반 엔드포인트에는 API Key를 직접 보내지 말고, Access Token만 사용하세요.
모든 일반 API 요청의 Authorization 헤더에 Bearer 형식으로 Access Token을 포함해 주세요.
Authorization: Bearer YOUR_ACCESS_TOKENcurl -X GET "http://{{EDGE_IP}}:8100/api/v1/events" -H "Authorization: Bearer YOUR_ACCESS_TOKEN"이 페이지의 예시는 API 빠른 시작에서 안내하는 로컬 기본 호스트를 사용합니다. 같은 요청을 공개 HTTPS 환경에서 검증하려면 호스트를 https://openapi.deeplyinc.com로 바꿔 테스트해 주세요.
Access Token이 만료되었거나 아직 발급되지 않았다면 토큰 재발급 API를 호출하세요.
이때는 Authorization: Bearer YOUR_API_KEY를 사용합니다.
인증에 실패하면 다음과 같은 응답을 받을 수 있습니다.
{
"detail": {
"message": "토큰이 만료되었습니다. 새 토큰을 재발급해 세션을 갱신해 주세요."
}
}const response = await fetch('http://{{EDGE_IP}}:8100/api/v1/events', {
method: 'GET',
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
});
const data = await response.json();