EFAM_가족관계등록부 신청

대법원 전자가족관계등록시스템 기본증명서, 가족관계증명서, 혼인관계증명서 신청 업무

METHOD

POST

URI

/scrap/common/efamily/FamilyRelationCertificate

Content Type

application/json

Charset

UTF-8

Last Updated

2024-02-27

Request Fields

필드명(영문) 필드명(한글) 필수여부 암호화여부 타입 양식 최대길이 샘플데이터 설명

REQNAME

요청자 이름

true

STRING

개인,법인 신청자명 입력해야 함.

REQJUMIN

요청자 주민등록번호

true

true

STRING

DEFAULTNMGUBUN

가족관계증명서 - 본인확인 추가정보 구분

true

STRING

1 - 부 성명
2 - 모 성명
3 - 배우자 성명
4 - 자녀 성명

DEFAULTNAME

가족관계증명서 - 본인확인 추가정보(성명)

true

STRING

PRICRLTGUBUN

가족관계증명서 - 본인과의 관계

STRING

1 : 본인 / 그외 기타
2 : 배우자
3 : 부
4 : 모
5 : 자녀

기본값은 본인

PRICRLTNAME

가족관계증명서 - 본인과의 관계에 대한 성명

STRING

배우자 또는 부 또는 모 또는 자녀의 성명 입력

본인과의 관계 구분 값이 1(본인) 이외일 경우 필수 입력

PRICRLTJUMIN

가족관계증명서 - 본인과의 관계에 대한 주민등록번호

true

STRING

배우자 또는 부 또는 모 또는 자녀의 주민번호 입력

본인과의 관계 구분 값이 1(본인) 이외일 경우 필수 입력

DECERT

기본증명서발급여부

true

STRING

Y:신청함
N:신청안함

가족관계증명원 기본증명서 신청여부

DECERTISSU

증명서발급수량

STRING

희망 발급 페이지수 입력
기본증명서 Y(신청)할 경우 필수입력

DECERTGUBUN

가족관계증명서-기본증명서 상세구분

STRING

1.일반
2.상세

현재는 상세만 열람
기본증명서 Y(신청)할 경우 필수입력

FAMCERT

가족관계증명서 발급여부

true

STRING

Y:신청함
N:신청안함

가족관계증명서 신청여부

FAMCERTISSU

가족관계증명서 - 증명서 발급수량

STRING

희망 발급 페이지수 입력.
가족관계증명서 Y(신청) 할 경우 필수 입력.

FAMCERTGUBUN

가족관계증명서 상세구분

STRING

1:일반
2:상세

현재는 상세만 열람
가족관계증명서 Y(신청) 할 경우 필수 입력

MARCERT

혼인관계증명서 발급여부

true

STRING

Y:신청함
N:신청안함

혼인관계증명서 신청여부

MARCERTISSU

가족관계증명서 - 혼인관계증명서 발급수

STRING

희망 발급 페이지수 입력
혼인관계증명서 Y(신청) 할 경우 필수 입력

MARCERTGUBUN

혼인증명신고서 상세구분

STRING

1:일반
2:상세

현재는 상세만 열람
혼인관계증명서 Y(신청) 할 경우 필수 입력

JUMINOPEN

주민등록번호 공개신청 여부(선택)

STRING

1:신청대상자 본인만 공개
2:전부 공개
3:전부 비공개

기본값은 전부 공개

REQREASON

가족관계증명서 - 발급사유

STRING

1:본인 확인용
2:회사 및 학교 제출용
3:개인 신분증명용
5:연말정산 제출용
8: 해외 제출용

기본값은 본인 확인용

P_CERTNAME

인증서이름

true

STRING

개별인증서를 위한 CERT 정보

P_CERTPWD

인증서 비밀번호

true

true

STRING

개별인증서를 위한 CERT 정보

P_SIGNCERT_DER

DER 파일

true

STRING

BASE64

개별인증서를 위한 CERT 정보

P_SIGNPRI_KEY

KEY 파일

true

STRING

BASE64

개별인증서를 위한 CERT 정보

Response Fields

필드명(영문) 필드명(한글) 필수여부 암호화여부 타입 양식 최대길이 샘플데이터 설명

errCode

errCode

STRING

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

errMsg

errMsg

STRING

오류발생 시 오류메시지

result

result

STRING

SUCCESS/FAIL

data.RESULT

전체 성공/실패 여부

STRING

SUCCESS : 성공
FAIL :실패

data.ERRMSG

에러메세지

STRING

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

data.ERRDOC

에러 문서 메시지

STRING

data.ECODE

에러코드

STRING

data.ETRACK

에러추적번호

STRING

data.BASICCERT

기본증명서

OBJECT

data.BASICCERT.BCADDR

등록기준지

STRING

data.BASICCERT.BCGUBUN

구분

STRING

data.BASICCERT.BCNAME

본인성명

STRING

data.BASICCERT.BCHANJANAME

본인한자성명

STRING

유니코드로 된 데이터 파싱

data.BASICCERT.BCBIRTHDAY

본인출생년월일

STRING

data.BASICCERT.BCJUMIN

본인주민등록번호

true

STRING

data.BASICCERT.BCGENDER

본인성별

STRING

data.BASICCERT.BCHANJABG

본인한자본관

STRING

유니코드로 된 데이터 파싱

data.BASICCERT.BCREGCNFIRM[]

기본증명서 등록사항 반복부

ARRAY

data.BASICCERT.BCREGCNFIRM[].BCRCGUBUN

구분

STRING

data.BASICCERT.BCREGCNFIRM[].BCRCDEINFO

상세내용

STRING

data.FAMILYCERT

가족관계증명서

OBJECT

data.FAMILYCERT.FCADDR

등록기준지

STRING

data.FAMILYCERT.FCGUBUN

구분

STRING

data.FAMILYCERT.FCNAME

본인성명

STRING

data.FAMILYCERT.FCHANJANAME

본인한자성명

STRING

유니코드로 된 데이터 파싱

data.FAMILYCERT.FCBIRTHDAY

본인출생년월일

STRING

data.FAMILYCERT.FCJUMIN

본인주민등록번호

true

STRING

data.FAMILYCERT.FCGENDER

가족 성별

STRING

data.FAMILYCERT.FCHANJABG

본인한자본관

STRING

유니코드로 된 데이터 파싱

data.FAMILYCERT.FCFAMILYCNFIRM[]

가족관계증명서 가족목록 반복부

ARRAY

data.FAMILYCERT.FCFAMILYCNFIRM[].FCNGUBUN

가족구분

STRING

data.FAMILYCERT.FCFAMILYCNFIRM[].FCNNAME

가족성명

STRING

data.FAMILYCERT.FCFAMILYCNFIRM[].FCNHANJANAME

가족한자성명

STRING

유니코드로 된 데이터 파싱.
사망자, 외국인, 주민번호 말소케이스는 해당필드가 출력되지 않음.

data.FAMILYCERT.FCFAMILYCNFIRM[].FCNBIRTHDAY

가족출생년월일

STRING

data.FAMILYCERT.FCFAMILYCNFIRM[].FCNJUMIN

가족주민번호

true

STRING

data.FAMILYCERT.FCFAMILYCNFIRM[].FCNGENDER

가족성별

STRING

data.FAMILYCERT.FCFAMILYCNFIRM[].FCNHANJABG

가족한자본관

STRING

유니코드로 된 데이터 파싱.
사망자, 외국인, 주민번호 말소케이스는 해당필드가 출력되지 않음.

data.FAMILYCERT.FCFAMILYCNFIRM[].FCNDEATHYN

가족사망여부

STRING

Y:사망, N:생존

data.FAMILYCERT.FCREGCNFIRM[]

가족관계증명서 등록사항 반복부

ARRAY

data.FAMILYCERT.FCREGCNFIRM[].FCRCGUBUN

구분

STRING

data.FAMILYCERT.FCREGCNFIRM[].FCRCDEINFO

상세내용

STRING

data.MARRYCERT

혼인관계증명서

OBJECT

data.MARRYCERT.MCADDR

등록기준지

STRING

data.MARRYCERT.MCGUBUN

구분

STRING

data.MARRYCERT.MCNAME

본인성명

STRING

data.MARRYCERT.MCHANJANAME

본인한자성명

STRING

유니코드로 된 데이터 파싱

data.MARRYCERT.MCBIRTHDAY

본인출생년월일

STRING

data.MARRYCERT.MCJUMIN

본인주민등록번호

true

STRING

data.MARRYCERT.MCGENDER

본인성별

STRING

data.MARRYCERT.MCHANJABG

본인한자본관

STRING

유니코드로 된 데이터 파싱

data.MARRYCERT.MCSPOUSE[]

혼인관계증명서 배우자 정보 반복부

ARRAY

data.MARRYCERT.MCSPOUSE[].MCNGUBUN

구분

STRING

data.MARRYCERT.MCSPOUSE[].MCNNAME

배우자성명

STRING

data.MARRYCERT.MCSPOUSE[].MCNHANJANAME

배우자한자성명

STRING

유니코드로 된 데이터 파싱

data.MARRYCERT.MCSPOUSE[].MCNBIRTHDAY

배우자출생년월일

STRING

data.MARRYCERT.MCSPOUSE[].MCNJUMIN

배우자주민번호

true

STRING

data.MARRYCERT.MCSPOUSE[].MCNGENDER

배우자성별

STRING

data.MARRYCERT.MCSPOUSE[].MCNHANJABG

배우자한자본관

STRING

유니코드로 된 데이터 파싱

data.MARRYCERT.MCDETAIL[]

혼인관계증명서 상세내용 반복부

ARRAY

data.MARRYCERT.MCDETAIL[].MCRCGUBUN

구분

STRING

data.MARRYCERT.MCDETAIL[].MCRCDATE

혼인신고일

STRING

data.MARRYCERT.MCDETAIL[].MCRCNAME

배우자성명

STRING

data.MARRYCERT.MCDETAIL2[]

혼인관계증명서 상세내용 반복부2

ARRAY

data.MARRYCERT.MCDETAIL2[].MCRCGUBUN

구분

STRING

data.MARRYCERT.MCDETAIL2[].MCRCDEINFO

상세내용

STRING

HTTP Request

POST /scrap/common/efamily/FamilyRelationCertificate
Host: https://datahub-dev.scraping.co.kr
Authorization: Token ******************************
Content-Length: 743
Content-Type: application/json;charset=UTF-8

{
  "REQNAME" : "홍길동",
  "REQJUMIN" : "8SxYL+DfTfMfIOWng==",
  "DEFAULTNMGUBUN" : "1",
  "DEFAULTNAME" : "홍철수",
  "PRICRLTGUBUN" : "3",
  "PRICRLTNAME" : "홍철수",
  "PRICRLTJUMIN" : "xv7HXHG4ccm6k4XN3OIs+w==\n",
  "DECERT" : "Y",
  "DECERTISSU" : "1",
  "DECERTGUBUN" : "1",
  "FAMCERT" : "Y",
  "FAMCERTISSU" : "1",
  "FAMCERTGUBUN" : "1",
  "MARCERT" : "Y",
  "MARCERTISSU" : "1",
  "MARCERTGUBUN" : "1",
  "JUMINOPEN" : "2",
  "REQREASON" : "1",
  "P_CERTNAME" : "cn=홍길동(),ou=SHB,ou=personal4IB,o=yessign,c=kr",
  "P_CERTPWD" : "QOf0TPlnwX4YNsrA==",
  "P_SIGNCERT_DER" : "MIIFmzCCBIOgAwIBAgIEJCSREDANBgkqQsF...GLlqn+XWQTrcdfB/KEtJLlSmL4/Bha6i4no=",
  "P_SIGNPRI_KEY" : "MIIFEDAaBggqgxqMmkQBDzAOBAgC+vZm...w+HVjzFOA1RLy5GNGOnnNAgst7QUmWCA=="
}

HTTP Response

HTTP/1.1 200 OK
Date:Tue, 27 Feb 2024 01:45:47 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Content-Length: 2526

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "ETRACK" : "",
    "ERRMSG" : "",
    "FAMILYCERT" : {
      "FCGENDER" : "남",
      "FCHANJANAME" : "00005d1400004ea8000071ee",
      "FCGUBUN" : "본인",
      "FCJUMIN" : "Scuy2mcmZniQupSgSQ==",
      "FCFAMILYCNFIRM" : [ {
        "FCNBIRTHDAY" : "1960년02월01일",
        "FCNGUBUN" : "부",
        "FCNHANJABG" : "",
        "FCNDEATHYN" : "N",
        "FCNNAME" : "홍철수",
        "FCNGENDER" : "남",
        "FCNHANJANAME" : "",
        "FCNJUMIN" : "8SxYL+DfTfMfIOWng=="
      }, {
        "FCNBIRTHDAY" : "1960년02월01일",
        "FCNGUBUN" : "모",
        "FCNHANJABG" : "00007f8500005dde",
        "FCNDEATHYN" : "N",
        "FCNNAME" : "홍철수",
        "FCNGENDER" : "여",
        "FCNHANJANAME" : "0000679700004e09000079ae",
        "FCNJUMIN" : "8SxYL+DfTfMfIOWng=="
      } ],
      "FCREGCNFIRM" : [ ],
      "FCHANJABG" : "00006d7700005dde",
      "FCBIRTHDAY" : "1989년11월09일",
      "FCADDR" : "서울특별시 중구 신당동 산 37번지",
      "FCNAME" : "홍길동"
    },
    "BASICCERT" : {
      "BCBIRTHDAY" : "1968년 10월 02일",
      "BCGENDER" : "남",
      "BCNAME" : "홍길동",
      "BCHANJANAME" : "00005d1400004ea8000071ee",
      "BCREGCNFIRM" : [ {
        "BCRCDEINFO" : "[가족관계등록부작성일] 2008년 01월 01일",
        "BCRCGUBUN" : "작성"
      }, {
        "BCRCDEINFO" : "[작성사유] 가족관계의 등록 등에 관한 법률 부칙 제3조제1항",
        "BCRCGUBUN" : "작성"
      } ],
      "BCADDR" : "서울특별시 중구 신당동 산 37번지",
      "BCGUBUN" : "본인",
      "BCJUMIN" : "8SxYL+DfTfMfIOWng==",
      "BCHANJABG" : "00006d7700005dde"
    },
    "ECODE" : "",
    "MARRYCERT" : {
      "MCBIRTHDAY" : "1990년11월02일",
      "MCSPOUSE" : [ {
        "MCNGUBUN" : "배우자",
        "MCNHANJANAME" : "000066fa00005c0f00007136",
        "MCNNAME" : "김영희",
        "MCNBIRTHDAY" : "1990년02월15일",
        "MCNGENDER" : "여",
        "MCNHANJABG" : "0000660c00005be7",
        "MCNJUMIN" : "QbRDl6fLYyQ5Du8sCQ=="
      } ],
      "MCHANJANAME" : "00005d1400004ea8000071ee",
      "MCGUBUN" : "본인",
      "MCGENDER" : "남",
      "MCDETAIL2" : [ {
        "MCRCGUBUN" : "혼인",
        "MCRCDEINFO" : "[배우자] 김영희"
      }, {
        "MCRCGUBUN" : "혼인",
        "MCRCDEINFO" : "[배우자] 김영희"
      } ],
      "MCADDR" : "서울특별시 중구 신당동 산 37번지",
      "MCHANJABG" : "00006d7700005dde",
      "MCNAME" : "홍길동",
      "MCJUMIN" : "Scuy/6k2mZ4pSgSQ==",
      "MCDETAIL" : [ {
        "MCRCGUBUN" : "혼인",
        "MCRCDATE" : "1995년07월29일",
        "MCRCNAME" : "김영희"
      } ]
    },
    "ERRDOC" : "",
    "RESULT" : "SUCCESS"
  }
}

Curl Request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/common/efamily/FamilyRelationCertificate' -i -X POST \
     -H 'Authorization: Token ******************************' \
     -H 'Content-Type: application/json;charset=UTF-8' \
     -d '{
  "REQNAME" : "홍길동",
  "REQJUMIN" : "8SxYL+DfTfMfIOWng==",
  "DEFAULTNMGUBUN" : "1",
  "DEFAULTNAME" : "홍철수",
  "PRICRLTGUBUN" : "3",
  "PRICRLTNAME" : "홍철수",
  "PRICRLTJUMIN" : "xv7HXHG4ccm6k4XN3OIs+w==\n",
  "DECERT" : "Y",
  "DECERTISSU" : "1",
  "DECERTGUBUN" : "1",
  "FAMCERT" : "Y",
  "FAMCERTISSU" : "1",
  "FAMCERTGUBUN" : "1",
  "MARCERT" : "Y",
  "MARCERTISSU" : "1",
  "MARCERTGUBUN" : "1",
  "JUMINOPEN" : "2",
  "REQREASON" : "1",
  "P_CERTNAME" : "cn=홍길동(),ou=SHB,ou=personal4IB,o=yessign,c=kr",
  "P_CERTPWD" : "QOf0TPlnwX4YNsrA==",
  "P_SIGNCERT_DER" : "MIIFmzCCBIOgAwIBAgIEJCSREDANBgkqQsF...GLlqn+XWQTrcdfB/KEtJLlSmL4/Bha6i4no=",
  "P_SIGNPRI_KEY" : "MIIFEDAaBggqgxqMmkQBDzAOBAgC+vZm...w+HVjzFOA1RLy5GNGOnnNAgst7QUmWCA=="
}'