Skip to main content

인증개요

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

인증방식

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

참고사항

caution

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

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

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

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

API 목록

MethodUrlDescription
POSThttps://openapi.vito.ai/v1/authenticate인증 토큰 요청

1) 인증 토큰 요청

HTTP 요청

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

요청 바디 (Request body)

application/x-www-form-urlencoded

FieldTypeRequired
client_idstringrequired
client_secretstringrequired

응답 바디 (Response Body)

  • 200 Success

application/json

{
// access token
access_token?: string
// expiration in unixtimestamp
expire_at?: integer
}

오류 코드

application/json

{
// 오류 코드 값
code?: string
}
HttpStatusCodeNameNotes
400H0001BadRequest잘못된 파라미터 요청
401H0002Unauthorized인증실패
500E500ServerError서버 오류

샘플 코드


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'