1. 간편인증이란?

원천 사이트에서는 공인인증서 또는 간편인증 절차를 통해 사용자의 추가적인 인증을 요구하는 경우가 많습니다. 이 때 간편인증은 아래 화면과 같은 인증 과정을 통해 이루어집니다.

2. 간편인증 흐름도

• Step 1

  • 최초 간편인증 API 요청
  • 사용자 간편인증 절차 진행

• Step 2

  간편인증 업무는 2단계를 거쳐 이용이 가능합니다.

  • Step1에서 응답받은 callback 정보를 Body에 입력 후 ‘scrap/captcha‘ URL에 Post 요청
  • 최종 결과 수신

  Step 1 - 최초 API 요청

3. 간편인증 API 요청 방법

Step1, Step2 과정의 실제 요청 입출력 예시입니다.

$ curl '<https://datahub-dev.scraping.co.kr/scrap/${*Simple}>' -i -X POST \
     -H 'Authorization: Token ******************************' \
     -H 'Content-Type: application/json;charset=UTF-8' \
     -d '{
	  "LOGINOPTION": "0", // 카카오톡 인증
	  "TELECOMGUBUN": "", // LOGINOPTION 통신사PASS 선택시 통신사 입력필드
	  "HPNUMBER": "01012341234", // 인증당사자의 휴대폰번호
	  "USERNAME": "김기웅", // 인증당사자의 이름
	  "JUMINNUM": "aRKYqiNBp0C+6zdUls4v0g==\n" // 생년월일(8자리) 또는 주민등록번호(13자리)
	  ...
}'

응답

{
    "errCode": "0001",
    "errMsg": "사용자 텍스트 입력 필요",
    "result": "FAIL",
    "data": {
        "callbackId": "66ced80df3cd0d0001302f4f",
        "callbackType": "SIMPLE",
        "callbackData": "",
        "timeout": 0
    }
}

Step 2 - 인증 후 ‘scrap/captcha’에 최종 요청

$ curl '<https://datahub-dev.scraping.co.kr/**scrap/captcha**>' -i -X POST \
     -H 'Authorization: Token ******************************' \
     -H 'Content-Type: application/json;charset=UTF-8' \
     -d '{
		  "callbackId": "{{callbackId}}", // Step1 에서 수신받은 callbackId
		  "callbackType": "{{callbackType}}", // 이 경우 간편인증으로 SIMPLE 입력
		  "callbackResponse": "",
		  "callbackResponse1": "",
		  "callbackResponse2": "",
		  "retry": ""
}'

최종 응답 수신

4. 주의사항

간편인증 과정에서 인증하지 않은 상태로 Step 2 요청시, 최대 3회까지 callbackId를 재응답하며 인증절차 진행 후 재요청 가능하도록 합니다.

또한 재요청시에 이전에 응답된 callbackId는 만료되어 해당 callbackId로는 요청할 수 없으며, 만약 만료된 callbackId를 요청 할 경우 API ErrorCode 3014 “이미 처래된 거래입니다”를 응답합니다.