# 확진자 확인증 진위여부 API 구현 예
## 개요
* 정부는 "확진 확인증(번호)"를 발급하고, 외부업체는 이를 받아, 제출한 사람을 확진자로 처리함.
* 전체흐름은 [정부의문서진위여부확인](https://www.gov.kr/confrm?a=AA040ConfirmIdApp) 방식과 동일함
* 정부-외부업체 간의 개인정보교환 없이 확진자인 확인만 해줄 수 있음.

### 구현방법
1. 확진자 개인은 확인증(번호)를 정부에 요청
2. 정부는 이를 받아 확인증(번호)를 **생성**하고, **내부DB에 저장**한 후, **사용자에게 발급** . 이때 만료기간은 1분 이내
3. 외부업체는 사용자에게 이를 받아서 정부 API로 요청함
4. 정부는 내부db에 번호를 조회하여, 진위여부를 확인해줌

### 사용자시나리오
1. 외부업체 앱에서 "확진자확인" 버튼을 누름
2. 자가격리앱의 "확진 확인증발급"메뉴로 자동이동(설치되어 있지 않으면,설치페이지로이동,아직 로그인 상태가 아니라면 로그인메뉴로 이동)
3. "확진 확인증 발급" 메뉴의 화면은 대략 아래와 같음
* XX앱으로 아래와 같은 확인증을 발급/전송할 준비가 되었습니다.
* 확인번호:324234-23423432-23423423-24234224
* 확진날짜:2020년3월19일
* 위 확인번호는 정부에서 발급했다는 것만을 증명하기 위해 생성된 번호로, 개인정보를 포함하고 있지 않습니다
4. 사용자는 "발급 및 재출" 버튼을 누름
5. 외부업체 앱이나 웹화면으로 이동하고 (이때 위 정보가 전달되고, 구현방법 4번이 진행이됨), 확인이 되었다는 메시지가 뜸
6. 5번과 같이 자동으로 처리되는 것이 부담스럽다면 사용자가 복사/붙여넣기 하는 방식으로 할수도 있음. (복사 붙여넣기 기능제공)
* 1회만 발급가능(확인증 번호가 진위여부 API에 입력되어 true를 보내준 이후에는 다시 발급되지 않음)

### 정부가 개발해야할 것
* "확진 확인증 발급" 메뉴가 자가격리앱에 추가되야함. (메인메뉴에 노출될 필요는 없음,환자정보가 입력된 상태에서만 열려야함) 이 메뉴를 열수 있는 방법이 공개되야함. 커스텀 스키마일수도 있고, 중간에 거치는 웹페이지를 만든 다음 여기서 메뉴를 띄울수도 있음
* 확인증 번호를 생성/저장/확인/만료 해줄수 있는 기능이 서버에 추가되야함.

### 공개되야할 API 스펙 (예)
* "확진 확인증 발급" 메뉴 이동 API
* 이동할수 있는 URL
* 전달파라미터: 업체명, 업체로 이동할 callback url
* 확인증 진위 여부 확인 API
* 호출URL
* 전달파라미터: 업체명, 확인증번호
* 결과값: true, false

### 참고
* 확인번호를 이동시키는 주체는 사용자임.
* A폰에서 확인증을 받아서 B폰에 입력하지 못하도록 callback url에 인증값이 포함되어 있음