기존 OpenAPI의 Body 기반 인증 방식은 보안상 한계가 있어, 👉 1회성 Access Token 발급 후 API 호출 시 헤더에 포함하는 방식으로 개선되었습니다.

발급받은 Access Token은 다우오피스 OpenAPI 호출 시 다음과 같이 사용합니다. 

Authorization: Bearer {ACCESS_TOKEN}
  • 위치 : OpenAPI > 인증키 연동 > 인증 Token 발행
  • 대상 : 모든 OpenAPI 공통 (근태/연차 API 포함)
  • 비고 : 기존 인증 방식도 하위호환을 위해 유지되며, 순차적으로 Token 기반으로 전환 예정

 

 

✔️ Request URL

https://api.daouoffice.com/public/auth/v1/oauth2/token

해당 API는 다우오피스 OpenAPI Request URL(api.daouoffice.com)을 사용합니다.

 

 

✉️ Request Body

Header

변수타입필수사전발급설명
AuthorizationString✅✅

RFC 6749 표준의 Basic 인증 방식 사용.

client_id와 client_secret을 :로 연결 후 Base64 인코딩하여 Authorization 헤더에 포함.

예) Authorization: Basic bXlfY2xpZW50X2lkOm15X2NsaWVudF9zZWNyZXQ=

 

Parameter

변수타입필수사전발급설명
grant_typeString✅⛔고정값 client_credentials 사용

 

 

✉️ Request 예시

POST https://api.daouoffice.com/public/auth/v1/oauth2/token
Authorization : Basic Y2xpZW50SWQ6Y2xpZW50U2VjcmV0
Content-Type : application/x-www-form-urlencoded
grant_type=client_credentials

 

 

📬 Response Body

성공 시

변수타입필수사전발급설명
token_typeString✅⛔토큰 타입, DOAS에서는 bearer 고정
expires_inString✅⛔토큰 유효기간(초 단위), 현재 1일(86400초)
access_tokenString✅⛔Access Token, DOAS API 호출 시 Authorization 헤더에 포함

 

실패 시

변수타입필수사전발급설명
codeString✅⛔오류 코드
messageString✅⛔오류 유형
messageDetailString⛔⛔오류 상세 설명

 

 

📬 Response 예시

성공

json

{

"token_type" : "bearer",
"expires_in" : 86400,
"access_token" : "eyJhbGciOiJIUzI1NiJ9...",

}

 

실패

json

{

"code" : "401",
"message" : "invalid_client",
"messageDetail" : "연동ID(clientId)를 확인하세요"

}

 

 

🚫 주요 오류 코드 예시

코드내용설명(Description)
400필수 파라미터 누락연동ID(client id)가 누락되었습니다.
연동비밀키(client secret)가 누락되었습니다.
grant type이 누락되었습니다.
400지원되지 않는 타입지원되지 않는 grant type 입니다.
401유효하지 않은 client ID, Client Secret연동 ID(client ID)를 확인하세요.
연동 비밀키(client Secret)를 확인하세요.

 

원하는 답을 찾지 못하셨나요?

스피키에게 물어보기

궁금한 기능이나 사용 방법을 AI 챗봇이 바로 알려 드립니다.

경로화면 오른쪽 아래 스피키 아이콘 선택

1:1 문의 등록하기 관리자

오류·장애 등 기술 지원은 관리자 계정으로 요청해 주세요.

경로화면 오른쪽 위 [문의등록] 선택