데이터허브 API를 통해, 은행/카드사/보험사/공공기관 등에서 제공되는 다양한 데이터를 신속하고 간편하게 수집할 수 있습니다.
수집되는 데이터를 활용하여 End User에게 맞춤 서비스를 제공해보세요.

본 문서에서는 데이터허브 API에 대해 소개하고, API 사용에 공통적으로 적용되는 내용에 대해 알려드립니다.

Data Flow

API Data

Request Data

API 요청시 다음의 기준으로 정의되어 호출되어야 합니다.

HTTP Header 부분

HTTP Body 부분 (DATA 부분)

요청하는 API 별로 요구되는 데이터는 API Guide 문서를 참조하세요.

Response Data

- API 응답은 JSON format 으로 제공됩니다. - API 응답시 data부와 공통부의 응답으로 구분되어 전달됩니다.

API Domain

MDH API는 인증이 필요한 API를 제공합니다.
API Domain은 개발 및 테스트용과 실서비스용으로 구분하여 제공됩니다.

● 개발 및 테스트용 API Domain : https://datahub-dev.scraping.co.kr
● 실 서비스 제공용 API Domain : https://api.mydatahub.co.kr

개발 및 테스트용 Domain은 실 서비스 제공용 Domain과 달리, 사전에 별도 공지없이 여러가지 업데이트 있을 수 있으며, 이에 따른 오류현상이 발생할 수 있으므로 참고하시기 바랍니다.

MDH에서 제공하는 API 전체 목록입니다. API를 누르시면 각 가이드페이지로 이동합니다.

금융

세무

공공

생활

전자증빙

간편인증이란?

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

간편인증 흐름도

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

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

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

간편인증 API 요청 방법

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

Step 1 - 최초 API 요청

$ 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" : "",,
}'

최종 응답 수신

주의사항

간편인증 과정에서 인증하지 않은 상태로 Step 2 요청시, 최대 3회까지 callbackId를 재응답하며 인증절차 진행 후 재요청 가능하도록 합니다.
이 때 사용자의 인증여부는 확인할 수 없습니다.
또한 재요청시에 이전에 응답된 callbackId는 만료되어 해당 callbackId로는 요청할 수 없으며,
만약 만료된 callbackId를 요청 할 경우 API ErrorCode 3014 “이미 처래된 거래입니다”를 응답합니다.

기타

위 내용으로 해결이 어려우셨다면, 기웅정보통신 고객지원을 통해 언제든 문의주세요.