✅ 해당 기능이 제공되는 다우오피스 상품 유형
| 무료 | 서비스형 | 엔터프라이즈형 | HR형 | ||
|---|---|---|---|---|---|
| 스탠다드 | 스탠다드 | 프리미엄 | 스탠다드 | 프리미엄 | HR |
| ❌ | ❌ | ❌ | |||
다우오피스 OpenAPI?
OpenAPI는 다우오피스의 정보를 외부 시스템과 연결(연동)할 수 있게 도와주는 기술입니다.
예를 들어, 다른 회사 시스템에서 다우오피스의 근태 정보, 전자결재, 알림 등을 자동으로 가져오거나 보낼 수 있습니다. 이를 통해 중복 입력을 줄이고, 업무를 자동화할 수 있습니다.
👉🏼누가 사용하나요? 개발자 또는 외부 시스템을 운영하는 IT 관리자
시스템 연동 설정
OpenAPI를 더 안전하게 사용하도록 돕는 중간 시스템인 시스템 연동 설정을 함께 이용하여야 합니다.
외부 시스템이 직접 다우오피스에 접속하지 않고, 시스템 연동 설정을 통해 중계하게 되어 보안과 안정성이 높아지며, 모든 요청과 결과는 연동 시스템에 기록(log)되므로 문제 발생 시 추적이 쉽습니다!
즉, 시스템 연동 설정은 OpenAPI를 쓸 때, 보안 게이트 역할을 하고 있습니다.
OpenAPI 이용 방법
1️⃣ OpenAPI 제공 대상 및 사용 가능 여부 확인
| 상품 | OpenAPI 제공 여부 |
|---|---|
| 엔터프라이즈형 (스탠다드/프리미엄) | 기본 제공 (별도 신청 불필요) |
| 서비스형 (스탠다드/프리미엄) |
❌ 제공되지 않음 → 엔터프라이즈형 업그레이드 후 이용 가능 |
2️⃣ 연동 기능 위치 및 확인 방법
엔터프라이즈형 상품 이용 고객사는 최고관리자 권한으로 아래 경로에서 OpenAPI 기능을 확인할 수 있습니다.
-
🧭통합설정⚙️ > 시스템연동 > 연동관리 > 오픈API 확인
위 메뉴가 보이지 않을 경우 고객센터1599-9460로 문의해주세요.
3️⃣ 인증키 발급(필수)
OpenAPI 사용을 위해서는 고유 인증키 발급이 반드시 필요합니다.
- 고객사 1곳당 1개의 인증키가 발급
- OpenAPI 호출 시 인증키가 보안 인증 역할 수행
4️⃣ Access Token 발행 (필수)
기존 Body 기반 인증 방식은 보안상 한계가 있어 아래 방식으로 개선되었습니다.
- Access Token을 발급 → API 호출 시 헤더에 포함
- OpenAPI > 인증키 연동 > 인증 Token 발행
-
Access Token은 모든 OpenAPI 공통으로 사용(근태·전자결재·Works·조직정보 등 포함)
기존 인증 방식은 하위 호환을 위해 유지되며 순차적으로 Token 방식으로 전환 예정입니다!
5️⃣ Open API 설정
발급된 인증키를 확인한 뒤 아래에서 OpenAPI 기능을 활성화해주세요.
6️⃣ 개발 연동
인증키 발급 및 활성화가 완료되면 개발자가 제공된 설명서(API 스펙 문서)를 참고하여 연동을 진행합니다.
- 방식 : REST API
- 응답 : JSON
- 서버IP : 35.216.3.121
- Port : 443(권장), 80
- 개발 사전 체크 : 방화벽 정책에서 위 서버 IP/Port가 허용되어 있는지 확인하세요.
제공 API 종류
| 기능 | API명 | Method | 비고 |
|---|---|---|---|
| 연동인증 | 인증키 발급 | POST | 업무시스템 → 다우오피스 |
| 인증키 조회 | POST | 업무시스템 → 다우오피스 | |
| 인증키 재발급 | POST | 업무시스템 → 다우오피스 | |
| 근태정보 | 근태 유형 등록 | POST | 업무시스템 → 다우오피스 |
| 근태 기록 등록 | POST | 업무시스템 → 다우오피스 | |
| 전자결재 | 전자결재 기안 | POST | 업무시스템 → 다우오피스 |
| 전자결재 기안(팝업) | POST | 업무시스템 → 다우오피스 | |
| 전자결재 처리상태 전송 | POST | 업무시스템 → 다우오피스 | |
| 전자결재 본문 조회 | POST | 업무시스템 → 다우오피스 | |
| 전자결재 본문 조회(팝업) | POST | 업무시스템 → 다우오피스 | |
| 모바일 결재 #1 - 본문 저장 | POST | 업무시스템 → 다우오피스 | |
| 모바일 결재 #2 - 기안 | Mobile | 업무시스템 → 다우오피스 | |
| 알림 발송 | 알림 발송 | POST | 업무시스템 → 다우오피스 |
| Works | Works 등록 | POST | 업무시스템 → 다우오피스 |
| Works 수정 | PUT | 업무시스템 → 다우오피스 | |
| Works 삭제 | DELETE | 업무시스템 → 다우오피스 | |
| 조직정보 | 계정 정보 조회 | POST | 다우오피스 → 업무시스템 |
| 부서 정보 조회 | POST | 다우오피스 → 업무시스템 | |
| 부서원 정보 조회 | POST | 다우오피스 → 업무시스템 | |
| 계정 부가 정보 조회(직위/직급/직책/ 사용자 그룹) | POST | 다우오피스 → 업무시스템 |
사용 API 개별 설정 - 전자결재
API 사용을 위해 🧭통합설정⚙️> App 관리 > 전자결재 > 결재 양식 관리 > [양식 상세 설정]으로 접근합니다.
1️⃣ 전자결재 양식 상세 설정
-
양식 상세 설정 > 기본
- 결재 양식 제목, 약어, 사용 여부 설정
- 기타에서 시스템 연동 사용 체크 및 전자결재연동_v4 선택
- 외부 시스템에서 정의한 해당 양식코드를 [코드] 입력 영역에 입력
2️⃣ 결재방 설정
🧭통합설정⚙️> App 관리 > 전자결재 > 결재 양식 관리> 양식편집기 > 결재 양식 제목 및 결재방 등 설정
-
고객사 정책에 따라 제목, 결재방 등 생성
- 전자결재 width값은 800px로 제작
- 인쇄(Print)가 필요한 경우 폭(width)을 800px 이내로 설정을 권장하나 외부 업무 시스템에서 다른 폭으로 전달되는 경우 전달 받는 폭에 맞춰 변경
-
양식 편집기 하단 [HTML 편집기] 선택
- <div data-id=“appContent”> 태그 값 추가
- 제목 연동 태그 값 : <div data-id="appTitle"></div>
- 필드 연동 태그 값 : <div data-id="appPostParam{n}"><br></div>
사용 API 개별 설정 - 근태
1️⃣ 근태 자동 동기화 주기 설정
🧭통합설정⚙️ > 시스템 연동 > 연동 관리 > [OpenAPI]에서 API 추가를 통해 근태 연동 설정을 진행하세요.
2️⃣ 근태 동기화를 위한 계정 사번 설정
📌동기화를 위해 계정 코드를 외부 시스템 사원번호와 다우오피스의 인식번호(사번/학번)를 동일하게 등록하는것이 포인트!
-
🧭경영업무포털 > 인사 > 인사관리 > [사원정보관리]에서 연동 대상자 선택
- [사원정보]에서 ADT캡스의 사원번호와 인식번호(사번/학번)를 동일하게 등록
- 사원정보관리에서 연동 대상자 클릭
- 연동 대상자의 [사원정보]에서 인식번호(사번/학번)정보를 '사원번호' 등록값과 동일하게 등록
3️⃣ 근태 동기화 데이터 수정 제한
연동된 근태 기록에 대한 변경을 방지하기 위해 근태 설정이 추가로 필요합니다. 해당 설정은 고객사 정책에 맞춰 적용하시면 됩니다.
🧭통합설정⚙️ > App 관리 > 경영업무포털 > 근태 > 근태 기본설정 > [외부기관 근태연동]을 이용해주세요.
자세한 내용은 외부기관 근태연동 내 가이드를 추가로 참고해주시기 바랍니다.