HKOR_외국인증진위여부조회

하이코리아 외국인등록증 진위여부 조회 업무

METHOD

POST

URI

/scrap/docInq/hikorea/AuthenticityOfForeigner

Request fields

필드명(영문) 필드명(한글) 암호화여부 양식 설명

FOREIGNJUMIN

외국인등록번호

TRUE

외국인등록번호

ISSUEDATE

발급일자

TRUE

yyyyMMdd

문서발급업무의 경우 실시간이므로 당일날짜

Response fields

필드명(영문) 필드명(한글) 암호화여부 양식 설명

data.INQNORMALPE

조회정상여부

정상 P, 에러 E

data.FOREIGNJUMIN

외국인등록번호

TRUE

외국인등록번호

data.ISSUEDATE

발급일자

TRUE

yyyyMMdd

문서발급업무의 경우 실시간이므로 당일날짜

data.REGCHECKYN

일치여부

외국인등록 일치여부 : Y-일치 / N-불일치

data.ERRMSG

에러메세지

RESULT값이 FAIL일 경우 스크래핑 서비스 오류 메세지 출력

errCode

errCode

정상일 때는 '0000', 오류일 경우 오류코드 반환

errMsg

errMsg

오류발생 시 오류메시지

result

result

SUCCESS/FAIL

HTTP request

POST /scrap/docInq/hikorea/AuthenticityOfForeigner HTTP/1.1
Content-Length: 93
Host: datahub-dev.scraping.co.kr
Authorization: Token ******************************
Content-Type: application/json;charset=UTF-8

{
  "FOREIGNJUMIN" : "+ntfCmayqAj0/l0f3i6oFg==",
  "ISSUEDATE" : "yEjt/8kSkEilFfzLIcAVtA=="
}

HTTP response

HTTP/1.1 200 OK
Content-Length: 252
Date: Thu, 24 Dec 2020 08:44:34 GMT
Connection: keep-alive
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "FOREIGNJUMIN" : "cBTmfl43SzJ/bOFIQHW5AA==",
    "ERRMSG" : "",
    "ISSUEDATE" : "cBTmfl43SzJ/bOFIQHW5AA==",
    "INQNORMALPE" : "P",
    "REGCHECKYN" : "Y"
  }
}

Curl request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/docInq/hikorea/AuthenticityOfForeigner' -i -X POST \
    -H 'Authorization: Token ******************************' \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "FOREIGNJUMIN" : "+ntfCmayqAj0/l0f3i6oFg==",
  "ISSUEDATE" : "yEjt/8kSkEilFfzLIcAVtA=="
}'