Skip to main content

인증 가이드

본 문서는 RTZR STT OpenAPI 의 인증 방식에 대해 안내합니다.

인증방식

RTZR STT OpenAPI에서는 OAuth2 기반의 client_id와 client_secret 쌍과 JWT 기반 인증을 사용하고 있습니다.

참고사항

caution

token의 만료 기간은 6시간입니다. 주기적으로 token이 갱신될 수 있도록 /v1/authenticate 을 통해 token을 갱신해야 합니다.

애플리케이션 등록 및 Secret 정보 확인

RTZR STT OpenAPI를 사용하기 위해서는 애플리케이션을 등록하고, API 연동 인증에 필요한 Secret 정보를 발급받아야 합니다. RTZR STT OpenAPI는 아래 절차를 따라 이용해 주시면 됩니다.

  1. RTZR 디벨로퍼스 사이트 회원가입
  2. 콘솔에 입장
  3. API 연동에 필요한 SECRET (client_id, client_secret) 정보 발급

API 목록

MethodURLDescription
POST/v1/authenticate인증 토큰 요청

1) 인증 토큰 요청

HTTP 요청

POST https://openapi.vito.ai/v1/authenticate

요청 바디 (Request body)

application/x-www-form-urlencoded

FieldTypeRequired
client_idstringrequired
client_secretstringrequired

샘플 코드


curl -X "POST" "https://openapi.vito.ai/v1/authenticate" \
-H "accept: application/json" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "client_id=${YOUR_CLIENT_ID}&client_secret=${YOUR_CLIENT_SECRET}"

응답 바디 (Response Body)

응답이 성공한 경우 HTTP Status 200과 함께 아래와 같은 응답을 내려줍니다.

{
"access_token": "{YOUR_JWT_TOKEN}",
"expire_at": 1690377931
}

오류 코드

HTTP StatusCodeNameNotes
400H0001BadRequest잘못된 파라미터 요청
401H0002Unauthorized인증실패
500E500ServerError서버 오류

아래는 응답이 실패한 경우 가운데 하나의 예시입니다.

{
"code": "H0002",
"msg": "invalid credential"
}