예약
예약 생성과 취소, 일정 변경, 예약 가능 시간 슬롯 조회, 내원흐름단계 변경, 만족도 조사 응답 조회를 지원합니다.
KOS Open API
우리 병원 데이터를우리가 원하는 모양으로
병원을 가장 잘 아는 사람은 병원에 있습니다. 그래서 KOS는 답을 정해 주는 대신 데이터를 열어 둡니다. 예약, 내원객, 상품, 수납, 통계, 시술권을 병원 서버에서 그대로 꺼내 쓰고, 필요한 화면과 규칙은 병원이 정합니다.
여섯 개 영역의 운영 데이터를API로 열어 두었습니다
조회, 수정, 삭제 요청을 모두 POST 방식으로 처리합니다. 전체 엔드포인트와 스키마는 개발자 문서에서 확인할 수 있습니다.
내원객
내원객 검색과 정보 조회, 초진 설문지 조회와 제출, 마케팅 수신 동의 해제를 지원합니다.
상품
상품과 상품 옵션의 조회·생성·수정·삭제, 카테고리와 타겟 국가 조회, 진료항목·약물·기기 목록 조회를 지원합니다.
수납
수납 목록과 내원객별 수납 내역, 선불카드 잔액과 충전 내역 조회를 지원합니다.
통계
예약, 결제, 내원객, 구매 항목, 시술 태스크, 잔여시술권 통계를 조회할 수 있습니다.
시술권
내원객이 사용할 수 있는 시술권 묶음 목록을 조회할 수 있습니다.
병원이 실제로 만드는연동 사례입니다
병원 홈페이지에 예약을 직접 붙입니다
예약 가능한 시간 슬롯을 조회해 병원 홈페이지의 디자인 그대로 예약 화면을 만들고, 접수된 예약을 KOS 예약 현황으로 바로 보냅니다.
병원이 쓰는 지표로 리포트를 만듭니다
예약, 결제, 내원객 통계를 내려받아 병원이 보던 기준으로 대시보드를 만듭니다. 집계 방식이 KOS와 같아 숫자가 어긋나지 않습니다.
사내 시스템과 데이터를 맞춥니다
그룹웨어, 회계 시스템, 마케팅 도구에 수납과 시술 데이터를 연결해 사람이 옮겨 적던 작업을 없앱니다.
자격 증명은병원 서버 밖으로 나가지 않습니다
API Key와 인증 토큰은 서버에서만 사용합니다. 브라우저에서 토큰을 교환하거나 저장하면 자격 증명이 노출되므로, 문서에서도 서버 사이드 처리를 요구합니다.
- 01
API Key를 발급받습니다
KOS 팀이 병원에 서버용 API Key를 발급합니다.
- 02
서버에서 인증 토큰으로 교환합니다
인증 토큰 교환 API에 API Key를 전달해 인증 토큰을 받습니다. 이 절차는 서버에서만 수행합니다.
- 03
Authorization 헤더로 호출합니다
발급받은 인증 토큰을 Authorization 헤더에 담아 요청합니다. 토큰이 만료되면 401 응답이 돌아오므로 다시 교환한 뒤 재시도합니다.
open-api.kos-solution.com
# 인증 토큰은 서버에서 API Key로 교환합니다
POST /visitor/open/v1/queries/find-visitor
Authorization: {{ Auth Token }}
Content-Type: application/json
{
"visitorName": "김미영",
"phone": { "countryCode": "82", "phoneNumber": "01012345678" }
}모든 요청은 POST로 보냅니다. 처리하지 못한 요청은 종류와 관계없이 400 응답과 함께 원인을 담은 본문을 돌려줍니다.
KOS Connect (개발 중)
직접 개발하지 않고 예약 화면을 붙이는 방법도 준비하고 있습니다
KOS Connect는 병원 홈페이지, LINE 미니앱, 독립 웹사이트에 KOS 예약 여정을 위젯으로 붙이는 부가 서비스입니다. 현재 개발 단계라 운영 환경에서는 사용할 수 없고, 정식 출시 전까지 기능과 사양이 바뀔 수 있습니다.
세 단계로 시작합니다
영업 담당자에게 문의합니다
KOS Open API는 KOS를 사용하는 병원의 개발팀이 대상입니다. 병원 담당자를 통해 사용 여부를 확인합니다.
API Key를 받습니다
KOS 팀이 병원에 서버용 API Key를 발급합니다.
문서를 보고 연동합니다
개발자 문서의 엔드포인트 설명과 OpenAPI 스펙을 보고 병원 시스템에 연결합니다.
새는 돈은 줄이고
매출은 더 크게
지금 바로 도입 문의하고KOS를 만나 보세요
문의 폼을 불러오고 있습니다.