개발자 문서
API 레퍼런스

증명서 - 4대보험

이 쪽의 모든 작업에 해당

  • 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [4대보험 로그인]

1. 증명서 신청/발급 입력 서식 조회fourinsure.b1.certificate.apply.init

MCP 도구 이름 fourinsure__b1__certificate__apply__init

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

로그인한 연동 계정의 증명서 신청 화면을 읽어 증명서 종류와 출력 순서 보기, 전화번호 칸, 미리 채워진 사업장 정보를 돌려줍니다.

  • params 는 빈 객체로 보내도 호출됩니다. 사용할 인증서는 account_link_id 로 지정합니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • fourinsure이 API 고정값 (기본값)

예시 : fourinsure

actionstring-Y호출할 작업입니다.
  • fourinsure.b1.certificate.apply.init이 API 고정값 (기본값)

예시 : fourinsure.b1.certificate.apply.init

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-N작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

추가 파라미터가 없습니다. params 는 {} 로 보냅니다.

bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: init-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "fourinsure",
  "action": "fourinsure.b1.certificate.apply.init",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • result.data 에서 입력 항목(fields)과 화면 정보를 확인해 다음 단계(fourinsure.b1.certificate.apply.submit)의 요청 본문을 만듭니다.
순번변수명타입설명
successboolean요청 처리 성공 여부
pageobject화면 페이지 메타 객체
formsarrayform 메타데이터 배열
fieldsarray입력 필드 계약 배열
semantic_fieldsarray의미 단위 입력 컨트롤 배열
semantic_payloadobject의미 필드 키-값 맵
semantic_field_countnumber의미 필드 개수
csrf_token_presentbooleanCSRF 토큰 존재 여부
followup_endpointsarray기관 화면이 다음 단계에서 부르는 주소 목록({url} 객체 배열)입니다. 우리 API 주소가 아니며 직접 호출하지 않습니다
navigation_stepsarray화면 내비게이션 단계 배열
current_viewstring현재 화면 식별자
target_readyboolean대상 폼 준비 여부
raw_html_lennumber원본 HTML 길이
source_urlstring서버가 요청한 기관 화면 주소
json
// result.data
{
  "page": {
    "title": "4대사회보험 정보연계센터",
    "headings": [
      "증명서발급",
      "증명서(가입내역확인_사업장,전체 가입자)신청/발급",
      "4대사회보험 가입내역 확인 청구서",
      "작성시 유의사항",
      "가입내역확인서 청구내역",
      "확인자",
      "근무중인 사업장",
      "증명서 발급신청 절차 안내",
      "개인정보보호",
      "위·변조금지"
    ]
  },
  "forms": [
    {
      "id": "submitForm",
      "name": "submit",
      "action": null,
      "method": "get"
    }
  ],
  "fields": [
    {
      "id": null,
      "tag": "input",
      "href": null,
      "name": "_csrf",
      "role": null,
      "text": "",
      "type": "hidden",
      "class": null,
      "title": "",
      "value": "[REDACTED]",
      "checked": false,
      "onclick": null,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "data_attrs": {},
      "placeholder": "",
      "option_count": 0,
      "selected_text": null
    },
    {
      "id": "tmpltKbrdrNm",
      "tag": "input",
      "href": null,
      "name": "tmpltKbrdrNm",
      "role": null,
      "text": "",
      "type": "hidden",
      "class": null,
      "title": "",
      "value": "홍길동",
      "checked": false,
      "onclick": null,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "data_attrs": {},
      "placeholder": "",
      "option_count": 0,
      "selected_text": null
    },
    {
      "id": "idntyTrprTelrno",
      "tag": "input",
      "href": null,
      "name": "idntyTrprTelrno",
      "role": null,
      "text": "",
      "type": "hidden",
      "class": null,
      "title": "",
      "value": null,
      "checked": false,
      "onclick": null,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "data_attrs": {},
      "placeholder": "",
      "option_count": 0,
      "selected_text": null
    },
    {
      "id": "idntyTrprTelono",
      "tag": "input",
      "href": null,
      "name": "idntyTrprTelono",
      "role": null,
      "text": "",
      "type": "hidden",
      "class": null,
      "title": "",
      "value": null,
      "checked": false,
      "onclick": null,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "data_attrs": {},
      "placeholder": "",
      "option_count": 0,
      "selected_text": null
    },
    {
      "id": "idntyTrprTelino",
      "tag": "input",
      "href": null,
      "name": "idntyTrprTelino",
      "role": null,
      "text": "",
      "type": "hidden",
      "class": null,
      "title": "",
      "value": null,
      "checked": false,
      "onclick": null,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "data_attrs": {},
      "placeholder": "",
      "option_count": 0,
      "selected_text": null
    },
    {
      "id": "idntyTrprOzip",
      "tag": "input",
      "href": null,
      "name": "idntyTrprOzip",
      "role": null,
      "text": "",
      "type": "hidden",
      "class": null,
      "title": "",
      "value": "12345",
      "checked": false,
      "onclick": null,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "data_attrs": {},
      "placeholder": "",
      "option_count": 0,
      "selected_text": null
    },
    {
      "id": "idntyTrprBscAddr",
      "tag": "input",
      "href": null,
      "name": "idntyTrprBscAddr",
      "role": null,
      "text": "",
      "type": "hidden",
      "class": null,
      "title": "",
      "value": "서울특별시 중구 예시로 123",
      "checked": false,
      "onclick": null,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "data_attrs": {},
      "placeholder": "",
      "option_count": 0,
      "selected_text": null
    },
    {
      "id": "idntyTrprDtlAddr",
      "tag": "input",
      "href": null,
      "name": "idntyTrprDtlAddr",
      "role": null,
      "text": "",
      "type": "hidden",
      "class": null,
      "title": "",
      "value": "123-4",
      "checked": false,
      "onclick": null,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "data_attrs": {},
      "placeholder": "",
      "option_count": 0,
      "selected_text": null
    },
    {
      "id": "idntyTrprBscRnmAddr",
      "tag": "input",
      "href": null,
      "name": "idntyTrprBscRnmAddr",
      "role": null,
      "text": "",
      "type": "hidden",
      "class": null,
      "title": "",
      "value": "서울특별시 중구 예시로 123",
      "checked": false,
      "onclick": null,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "data_attrs": {},
      "placeholder": "",
      "option_count": 0,
      "selected_text": null
    },
    {
      "id": "idntyTrprDtlRnmAddr",
      "tag": "input",
      "href": null,
      "name": "idntyTrprDtlRnmAddr",
      "role": null,
      "text": "",
      "type": "hidden",
      "class": null,
      "title": "",
      "value": "예시빌딩 4층 401호",
      "checked": false,
      "onclick": null,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "data_attrs": {},
      "placeholder": "",
      "option_count": 0,
      "selected_text": null
    },
    {
      "id": "powkBplcNm",
      "tag": "input",
      "href": null,
      "name": "powkBplcNm",
      "role": null,
      "text": "",
      "type": "hidden",
      "class": null,
      "title": "",
      "value": "예시 주식회사",
      "checked": false,
      "onclick": null,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "data_attrs": {},
      "placeholder": "",
      "option_count": 0,
      "selected_text": null
    },
    {
      "id": "powkBrno",
      "tag": "input",
      "href": null,
      "name": "powkBrno",
      "role": null,
      "text": "",
      "type": "hidden",
      "class": null,
      "title": "",
      "value": "1234567890",
      "checked": false,
      "onclick": null,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "data_attrs": {},
      "placeholder": "",
      "option_count": 0,
      "selected_text": null
    },
    {
      "id": "powkBpmno",
      "tag": "input",
      "href": null,
      "name": "powkBpmno",
      "role": null,
      "text": "",
      "type": "hidden",
      "class": null,
      "title": "",
      "value": "12345678901",
      "checked": false,
      "onclick": null,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "data_attrs": {},
      "placeholder": "",
      "option_count": 0,
      "selected_text": null
    },
    {
      "id": "issuUsgSeCd",
      "tag": "input",
      "href": null,
      "name": "issuUsgSeCd",
      "role": null,
      "text": "",
      "type": "hidden",
      "class": null,
      "title": "",
      "value": "1",
      "checked": false,
      "onclick": null,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "data_attrs": {},
      "placeholder": "",
      "option_count": 0,
      "selected_text": null
    },
    {
      "id": "joinDsctnCdocKndCd",
      "tag": "input",
      "href": null,
      "name": "joinDsctnCdocKndCd",
      "role": null,
      "text": "",
      "type": "hidden",
      "class": null,
      "title": "",
      "value": null,
      "checked": false,
      "onclick": null,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "data_attrs": {},
      "placeholder": "",
      "option_count": 0,
      "selected_text": null
    },
    {
      "id": "rcptMthdSeCd",
      "tag": "input",
      "href": null,
      "name": "rcptMthdSeCd",
      "role": null,
      "text": "",
      "type": "hidden",
      "class": null,
      "title": "",
      "value": "P",
      "checked": false,
      "onclick": null,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "data_attrs": {},
      "placeholder": "",
      "option_count": 0,
      "selected_text": null
    },
    {
      "id": "idntyTrprRrkey",
      "tag": "input",
      "href": null,
      "name": "idntyTrprRrkey",
      "role": null,
      "text": "",
      "type": "hidden",
      "class": null,
      "title": "",
      "value": "12345678901",
      "checked": false,
      "onclick": null,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "data_attrs": {},
      "placeholder": "",
      "option_count": 0,
      "selected_text": null
    },
    {
      "id": "otptSortSeCd",
      "tag": "input",
      "href": null,
      "name": "otptSortSeCd",
      "role": null,
      "text": "",
      "type": "hidden",
      "class": null,
      "title": "",
      "value": null,
      "checked": false,
      "onclick": null,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "data_attrs": {},
      "placeholder": "",
      "option_count": 0,
      "selected_text": null
    }
  ],
  "success": true,
  "source_url": "https://...",
  "current_view": "target_form",
  "raw_html_len": 64739,
  "target_ready": true,
  "semantic_fields": [
    {
      "id": "queryhead",
      "tag": "input",
      "name": "query",
      "text": "",
      "type": "text",
      "class": "ipt_totalsearch",
      "label": null,
      "title": "통합 검색어 입력 영역",
      "value": "",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "placeholder": "검색어를 입력해주세요.",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": null,
      "tag": "button",
      "name": null,
      "text": "통합검색",
      "type": null,
      "class": "btn_totalsearch",
      "label": null,
      "title": "",
      "value": "",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": null,
      "tag": "button",
      "name": null,
      "text": "메뉴 버튼",
      "type": "button",
      "class": "lnb_toggle_btn",
      "label": null,
      "title": "",
      "value": "",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "메뉴닫기",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": null,
      "tag": "button",
      "name": null,
      "text": "화면확대",
      "type": "button",
      "class": "btn_scale_plus",
      "label": null,
      "title": "",
      "value": "",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": null,
      "tag": "button",
      "name": null,
      "text": "화면축소",
      "type": "button",
      "class": "btn_scale_minus",
      "label": null,
      "title": "",
      "value": "",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": null,
      "tag": "button",
      "name": null,
      "text": "용어사전",
      "type": "button",
      "class": "btn_style h38 bg_darkblue radius19",
      "label": null,
      "title": "새창으로 열림",
      "value": "",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": "joinDsctnCdocKndCd1",
      "tag": "input",
      "name": "joinDsctnCdocKndCd",
      "text": "",
      "type": "radio",
      "class": null,
      "label": "사업장 가입자 명부",
      "title": "",
      "value": "",
      "checked": true,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": "joinDsctnCdocKndCd2",
      "tag": "input",
      "name": "joinDsctnCdocKndCd",
      "text": "",
      "type": "radio",
      "class": null,
      "label": "사업장 가입내역 확인서",
      "title": "",
      "value": "",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": "btnSubmit1",
      "tag": "button",
      "name": null,
      "text": "신청",
      "type": "button",
      "class": "btn_style minw100 h50 bg_gray f15",
      "label": null,
      "title": "",
      "value": "",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": "iptFlnm",
      "tag": "input",
      "name": null,
      "text": "",
      "type": "text",
      "class": "ipt_text",
      "label": null,
      "title": "성명 입력",
      "value": "홍길동",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": true,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": null,
      "tag": "input",
      "name": null,
      "text": "",
      "type": "text",
      "class": "ipt_text",
      "label": null,
      "title": "주민(외국인)등록번호 앞자리 입력",
      "value": null,
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": true,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": true,
      "selected_text": null
    },
    {
      "id": null,
      "tag": "input",
      "name": null,
      "text": "",
      "type": "password",
      "class": "ipt_text",
      "label": null,
      "title": "주민(외국인)등록번호 뒷자리 입력",
      "value": null,
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": true,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": true,
      "selected_text": null
    },
    {
      "id": "iptTelrno",
      "tag": "input",
      "name": null,
      "text": "",
      "type": "text",
      "class": "ipt_text",
      "label": null,
      "title": "전화번호(자택) 앞자리 입력",
      "value": "",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": "iptTelono",
      "tag": "input",
      "name": null,
      "text": "",
      "type": "text",
      "class": "ipt_text",
      "label": null,
      "title": "전화번호(자택) 가운데자리 입력",
      "value": "",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": "iptTelino",
      "tag": "input",
      "name": null,
      "text": "",
      "type": "text",
      "class": "ipt_text",
      "label": null,
      "title": "전화번호(자택) 뒷자리 입력",
      "value": "",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": "iptZipCd",
      "tag": "input",
      "name": null,
      "text": "",
      "type": "text",
      "class": "ipt_text",
      "label": null,
      "title": "우편물 수령지 우편번호 입력",
      "value": "12345",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": true,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": "iptAddr",
      "tag": "input",
      "name": null,
      "text": "",
      "type": "text",
      "class": "ipt_text",
      "label": null,
      "title": "우편물 수령지 기본주소 입력",
      "value": "서울특별시 중구 예시로 123",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": true,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": "iptDaddr",
      "tag": "input",
      "name": null,
      "text": "",
      "type": "text",
      "class": "ipt_text",
      "label": null,
      "title": "우편물 수령지 상세주소 입력",
      "value": "예시빌딩 4층 401호",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": true,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": null,
      "tag": "input",
      "name": null,
      "text": "",
      "type": "text",
      "class": "ipt_text",
      "label": null,
      "title": "사업장 입력",
      "value": "예시 주식회사",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": true,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": null,
      "tag": "input",
      "name": null,
      "text": "",
      "type": "text",
      "class": "ipt_text",
      "label": null,
      "title": "사업자등록번호 입력",
      "value": "1234567890",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": true,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": null,
      "tag": "input",
      "name": null,
      "text": "",
      "type": "text",
      "class": "ipt_text",
      "label": null,
      "title": "사업장관리번호 입력",
      "value": "12345678901",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": true,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": "lb02_01",
      "tag": "input",
      "name": "lb02",
      "text": "",
      "type": "radio",
      "class": null,
      "label": "확인용",
      "title": "",
      "value": "",
      "checked": true,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": "radioOtptSortSeCd1",
      "tag": "input",
      "name": "radioOtptSortSeCd",
      "text": "",
      "type": "radio",
      "class": null,
      "label": "이름순으로 출력",
      "title": "",
      "value": "2",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": "radioOtptSortSeCd2",
      "tag": "input",
      "name": "radioOtptSortSeCd",
      "text": "",
      "type": "radio",
      "class": null,
      "label": "주민등록순으로 출력",
      "title": "",
      "value": null,
      "checked": true,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": true,
      "selected_text": null
    },
    {
      "id": "btnSubmit2",
      "tag": "button",
      "name": null,
      "text": "신청",
      "type": "button",
      "class": "btn_style minw180 h50 bg_blue",
      "label": null,
      "title": "",
      "value": "",
      "checked": false,
      "options": [],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 0,
      "value_masked": false,
      "selected_text": null
    },
    {
      "id": "selectSite",
      "tag": "select",
      "name": null,
      "text": "",
      "type": null,
      "class": null,
      "label": null,
      "title": "유관기관 사이트 선택",
      "value": "",
      "checked": false,
      "options": [
        {
          "text": "유관기관 사이트",
          "value": "",
          "selected": false
        },
        {
          "text": "사회보험통합징수포털",
          "value": "https://...",
          "selected": false
        },
        {
          "text": "국민연금공단",
          "value": "https://...",
          "selected": false
        },
        {
          "text": "국민건강보험공단",
          "value": "https://...",
          "selected": false
        },
        {
          "text": "고용보험",
          "value": "https://...",
          "selected": false
        },
        {
          "text": "근로복지공단",
          "value": "https://...",
          "selected": false
        },
        {
          "text": "고용노동부",
          "value": "https://...",
          "selected": false
        },
        {
          "text": "한국고용정보원",
          "value": "https://...",
          "selected": false
        },
        {
          "text": "노인장기요양보험",
          "value": "https://...",
          "selected": false
        },
        {
          "text": "보건복지부",
          "value": "https://...",
          "selected": false
        },
        {
          "text": "건강iN",
          "value": "https://...",
          "selected": false
        },
        {
          "text": "건강보험심사평가원",
          "value": "https://...",
          "selected": false
        },
        {
          "text": "기초연금",
          "value": "https://...",
          "selected": false
        },
        {
          "text": "정부24",
          "value": "https://...",
          "selected": false
        }
      ],
      "disabled": false,
      "readonly": false,
      "required": false,
      "aria_label": "",
      "placeholder": "",
      "option_count": 14,
      "value_masked": false,
      "selected_text": "유관기관 사이트"
    }
  ],
  "navigation_steps": [
    {
      "url": "https://...",
      "phase": "enter_application_form",
      "method": "GET",
      "description": "증명서 신청 화면으로 이동"
    }
  ],
  "semantic_payload": {
    "신청": "신청",
    "신청_2": "신청",
    "확인용": "lb02_01",
    "메뉴닫기": "메뉴 버튼",
    "통합검색": "통합검색",
    "화면축소": "화면축소",
    "화면확대": "화면확대",
    "성명_입력": "홍길동",
    "사업장_입력": "예시 주식회사",
    "새창으로_열림": "용어사전",
    "이름순으로_출력": "radioOtptSortSeCd1",
    "사업장_가입자_명부": "joinDsctnCdocKndCd1",
    "사업자등록번호_입력": "1234567890",
    "사업장관리번호_입력": "12345678901",
    "주민등록순으로_출력": "radioOtptSortSeCd2",
    "유관기관_사이트_선택": "유관기관 사이트",
    "통합_검색어_입력_영역": "검색어를 입력해주세요.",
    "사업장_가입내역_확인서": "joinDsctnCdocKndCd2",
    "전화번호_자택_뒷자리_입력": "전화번호(자택) 뒷자리 입력",
    "전화번호_자택_앞자리_입력": "전화번호(자택) 앞자리 입력",
    "우편물_수령지_기본주소_입력": "서울특별시 중구 예시로 123",
    "우편물_수령지_상세주소_입력": "예시빌딩 4층 401호",
    "우편물_수령지_우편번호_입력": "12345",
    "전화번호_자택_가운데자리_입력": "전화번호(자택) 가운데자리 입력",
    "주민_외국인_등록번호_뒷자리_입력": "주민(외국인)등록번호 뒷자리 입력",
    "주민_외국인_등록번호_앞자리_입력": "주민(외국인)등록번호 앞자리 입력"
  },
  "csrf_token_present": true,
  "followup_endpoints": [
    {
      "url": "https://..."
    }
  ],
  "semantic_field_count": 26
}
순번오류 코드발생 조건
AUTH_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.
PROVIDER_AUTH_FAILED인증 만료 — 인증이 만료됐습니다. 로그인을 다시 호출합니다.
PROVIDER_UPSTREAM_ERROR업스트림 오류 — 기관 연결 실패, 응답 없음, 오류 응답, 읽을 수 없는 응답입니다. error.message 안내대로 잠시 후 다시 호출하거나 보낸 값과 연동 계정 권한을 확인합니다.

2. 증명서 신청/발급 제출fourinsure.b1.certificate.apply.submit

MCP 도구 이름 fourinsure__b1__certificate__apply__submit

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

사업장 가입내역 확인서와 가입자 명부 중 신청할 증명서를 기관에 제출하고 접수번호를 받습니다.

  • 요청 거절(HTTP 400, 작업은 만들어지지 않음).
  • 요청 거절(HTTP 409, 작업은 만들어지지 않음).
  • 되돌릴 수 없는 접수라 사용자 동의를 1회용 확인 토큰으로 받습니다(위 확인 토큰 필요 행).

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • fourinsure이 API 고정값 (기본값)

예시 : fourinsure

actionstring-Y호출할 작업입니다.
  • fourinsure.b1.certificate.apply.submit이 API 고정값 (기본값)

예시 : fourinsure.b1.certificate.apply.submit

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-Y작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입필수설명
selectionstringY증명서 종류. 2=사업장 가입내역확인서, 3=사업장 가입자명부. 별칭은 document_type 입니다
output_sort_codestringN출력 정렬 otptSortSeCd. 1=이름순, 2=주민등록순. 기본 1
phone_areastringN연락처 지역번호 idntyTrprTelrno
phone_exchangestringN연락처 국번호 idntyTrprTelono
phone_linestringN연락처 끝번호 idntyTrprTelino
confirmbooleanN지금은 쓰지 않는 값입니다. 보내지 않습니다. 제출 동의는 1회용 확인 토큰(confirmation_token)으로 받습니다
confirm_submitbooleanN실제로 제출할지 정하는 값입니다. 보내지 않으면 true 입니다. false 로 보내면 기관에 제출하지 않고 입력값만 확인하며, 응답의 submitted 가 false 입니다. 제출 동의는 이 값이 아니라 1회용 확인 토큰(confirmation_token)으로 받습니다
dry_runbooleanNtrue 로 보내면 기관에 제출하지 않고 입력값만 확인합니다. 보내지 않으면 false 입니다. 응답의 submitted 는 false, dry_run 은 true 이며 confirm_submit 을 false 로 보낸 것과 같습니다
confirmation_tokenstringN1회용 확인 토큰입니다. 처음에는 보내지 않습니다. 토큰 없이 부르면 기관에 아무것도 보내지 않고 작업도 만들지 않은 채 확인이 필요하다는 오류(WRITE_CONFIRMATION_REQUIRED)로 끝나고, 응답의 error.confirmation_token 에 토큰이 옵니다. error.message 의 안내를 사용자에게 보여 주고 동의를 받은 뒤 같은 요청에 이 토큰을 넣어 다시 부릅니다. 토큰은 10분 안에 한 번만 쓸 수 있고 처음 요청과 같은 본문, 같은 호출자, 같은 환경에서만 맞으며, 아니면 확인이 만료됐거나 내용이 달라졌다는 오류로 거절합니다
  • 「<필수>」 자리는 예시 값이 없는 필수 칸입니다. 위 파라미터 표를 보고 실제 값으로 바꿔 보냅니다.
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: submit-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "fourinsure",
  "action": "fourinsure.b1.certificate.apply.submit",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "selection": "<필수>"
  }
}'

Response

  • result.data 의 submitted 로 접수됐는지, cvrc_no 와 received_at 으로 접수 번호와 시각을 확인합니다. dry_run 이 true 면 접수하지 않은 검증 결과입니다.
순번변수명타입설명
successboolean요청 처리 성공 여부
submittedboolean실제 제출 수행 여부
dry_runboolean접수 없이 검증만 한 호출이면 true
selectionstring선택한 증명서 종류
join_dsctn_cdoc_knd_cdstring가입내역확인서 종류 코드
output_sort_codestring출력 정렬 코드
cvrc_nostring | null증명서 접수번호
request_typestring신청 유형
received_atstring접수 일시
process_agenciesarray처리 기관 배열
statusesarray처리 상태 배열
issued_atstring | null발급 일시
form_hiddenobjecthidden form 필드 맵
navigation_stepsarray화면 내비게이션 단계 배열
source_urlstring서버가 요청한 기관 화면 주소
raw_html_lennumber원본 HTML 길이
status_codestring출력 상태를 하나로 요약한 코드입니다. 접수까지 실제로 한 결과(submitted 가 true)에만 옵니다.
print_button_presentboolean제출한 신청의 상세 화면에 인쇄 버튼이 있는지 여부입니다. submitted 가 true 일 때만 옵니다.
print_availableboolean지금 인쇄할 수 있는지 여부입니다(출력 상태가 인쇄 가능이고 인쇄 버튼이 있을 때 true). submitted 가 true 일 때만 옵니다.
pdf_download_availableboolean지금 PDF 로 내려받을 수 있는지 여부입니다(인쇄 가능 여부와 같은 값). submitted 가 true 일 때만 옵니다.
outcomestring접수 판정입니다. 기관이 매긴 접수번호를 읽었으면 confirmed 입니다. 읽지 못하면 작업 API 는 결과 대신 실패(error_code PROVIDER_OUTCOME_UNCONFIRMED, 재시도 불가)로 끝나고, REST 응답은 이 칸이 unconfirmed 이고 success 가 false 입니다. submitted 가 true 일 때만 값이 있습니다.
message_kostringREST 응답에서 outcome 이 unconfirmed 일 때만 값이 있는 안내 문장입니다. 작업 API 는 이 문장을 실패의 오류 문장 앞부분으로 줍니다.
how_to_kostringREST 응답에서 outcome 이 unconfirmed 일 때만 값이 있습니다. 다시 신청하기 전에 신청 이력에서 방금 신청이 접수됐는지 확인하는 방법을 알려 줍니다. 작업 API 는 이 문장을 실패의 오류 문장 뒤에 붙여 줍니다.
actionstring작업 API 결과에만 있는 칸입니다. 접수를 확인했을 때 이 액션 이름이 그대로 옵니다. REST 응답에는 없습니다. submitted 가 true 일 때만 옵니다.
json
// result.data
{
  "success": true,
  "submitted": true,
  "dry_run": false,
  "selection": "사업장 가입내역 확인서",
  "join_dsctn_cdoc_knd_cd": "2",
  "output_sort_code": "1",
  "cvrc_no": "...",
  "request_type": "...",
  "received_at": "2026-06-15 10:00:00",
  "process_agencies": ["..."],
  "issued_at": "...",
  "statuses": ["접수"],
  "status_code": "UNKNOWN",
  "print_button_present": false,
  "print_available": false,
  "pdf_download_available": false,
  "form_hidden": {},
  "navigation_steps": [],
  "raw_html_len": 0,
  "source_url": "https://...",
  "outcome": "confirmed",
  "action": "fourinsure.b1.certificate.apply.submit"
}
순번오류 코드발생 조건
AUTH_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.
PROVIDER_AUTH_FAILED인증 만료 — 인증이 만료됐습니다. 로그인을 다시 호출합니다.
PROVIDER_OUTCOME_UNCONFIRMED처리 확인 불가 — 기관이 오류로 답하거나 연결이 끊겨 신청이 접수됐는지 알 수 없을 수 있으니, 다시 신청하지 말고 증명서 신청이력 목록 조회로 방금 낸 신청이 있는지 먼저 확인합니다. 기관이 오류 응답을 보내거나 응답이 오지 않거나 연결이 끊긴 경우 error.message 는 결과 확인 불가 안내('기관의 요청 처리 여부를 확인하지 못했습니다. 다시 실행하지 마세요. 이미 처리됐을 수 있어 중복 처리로 이어집니다.')입니다.
PROVIDER_UPSTREAM_ERROR처리 확인 불가 — 기관이 오류로 답하거나 연결이 끊겨 신청이 접수됐는지 알 수 없을 수 있으니, 다시 신청하지 말고 증명서 신청이력 목록 조회로 방금 낸 신청이 있는지 먼저 확인합니다. 기관이 오류 응답을 보내거나 응답이 오지 않거나 연결이 끊긴 경우 error.message 는 결과 확인 불가 안내('기관의 요청 처리 여부를 확인하지 못했습니다. 다시 실행하지 마세요. 이미 처리됐을 수 있어 중복 처리로 이어집니다.')입니다.
PROVIDER_VALIDATION_ERROR검증 오류 — 보낸 값이 빠졌거나 형식이 맞지 않거나 값에 맞는 대상을 찾지 못한 경우입니다. error.message 가 알려 주는 값을 고쳐 다시 호출합니다.

3. 증명서 신청이력 상세 조회fourinsure.b1.certificate.history.detail

MCP 도구 이름 fourinsure__b1__certificate__history__detail

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

접수번호 하나로 증명서 신청 건의 상세를 열어 접수일시, 처리 기관마다의 상태, 발급일자, 출력 가능 여부를 받습니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • fourinsure이 API 고정값 (기본값)

예시 : fourinsure

actionstring-Y호출할 작업입니다.
  • fourinsure.b1.certificate.history.detail이 API 고정값 (기본값)

예시 : fourinsure.b1.certificate.history.detail

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-Y작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입필수설명
cvrc_nostringY증명서 신청이력 상세 조회용 민원번호 cvrcNo
group_cvrc_nostringN그룹 민원번호 groupCvrcNo. 기본 ""
  • 「<필수>」 자리는 예시 값이 없는 필수 칸입니다. 위 파라미터 표를 보고 실제 값으로 바꿔 보냅니다.
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: detail-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "fourinsure",
  "action": "fourinsure.b1.certificate.history.detail",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "cvrc_no": "<필수>"
  }
}'

Response

  • result.data 의 statuses 로 처리 상태를, pdf_download_available 로 PDF 를 받을 수 있는지 확인합니다.
순번변수명타입설명
successboolean요청 처리 성공 여부
cvrc_nostring증명서 접수번호
request_typestring신청 유형
received_atstring접수 일시
process_agenciesarray처리 기관 배열
statusesarray처리 상태 배열
issued_atstring | null발급 일시
status_codestring상태 코드
print_button_presentboolean인쇄 버튼 존재 여부
print_availableboolean인쇄 가능 여부
pdf_download_availablebooleanPDF 다운로드 가능 여부
form_hiddenobjecthidden form 필드 맵
source_urlstring서버가 요청한 기관 화면 주소
json
// result.data
{
  "success": true,
  "cvrc_no": "...",
  "request_type": "...",
  "received_at": "2026-06-15",
  "process_agencies": [],
  "statuses": [],
  "issued_at": "2026-06-15",
  "status_code": "...",
  "print_button_present": true,
  "print_available": true,
  "pdf_download_available": true,
  "form_hidden": {},
  "source_url": "..."
}
순번오류 코드발생 조건
AUTH_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.
PROVIDER_AUTH_FAILED인증 만료 — 인증이 만료됐습니다. 로그인을 다시 호출합니다.
PROVIDER_UPSTREAM_ERROR업스트림 오류 — 기관 연결 실패, 응답 없음, 오류 응답, 읽을 수 없는 응답입니다. error.message 안내대로 잠시 후 다시 호출하거나 보낸 값과 연동 계정 권한을 확인합니다.
VALIDATION_INVALID_FIELD필수 칸 누락 — 필수 칸(cvrc_no)이 비어 있어 기관을 부르기 전에 거절했습니다. error.message 가 빠진 칸 이름을 알려 줍니다. 재시도 불가로 표시되니 그 칸을 채워 다시 호출합니다.

4. 증명서 신청이력 상세 입력 서식 조회fourinsure.b1.certificate.history.detail_init

MCP 도구 이름 fourinsure__b1__certificate__history__detail_init

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

증명서 신청이력 목록 조회에서 받은 접수번호를 넣으면 그 건 상세 화면의 출력 양식 칸과 출력 처리 주소를 돌려줍니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • fourinsure이 API 고정값 (기본값)

예시 : fourinsure

actionstring-Y호출할 작업입니다.
  • fourinsure.b1.certificate.history.detail_init이 API 고정값 (기본값)

예시 : fourinsure.b1.certificate.history.detail_init

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-Y작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입필수설명
cvrc_nostringY증명서 신청이력 상세 조회용 민원번호 cvrcNo
group_cvrc_nostringN그룹 민원번호 groupCvrcNo. 기본 ""
  • 「<필수>」 자리는 예시 값이 없는 필수 칸입니다. 위 파라미터 표를 보고 실제 값으로 바꿔 보냅니다.
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: detail_init-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "fourinsure",
  "action": "fourinsure.b1.certificate.history.detail_init",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "cvrc_no": "<필수>"
  }
}'

Response

  • result.data 에서 입력 항목(fields)과 화면 정보를 확인해 다음 단계(fourinsure.b1.certificate.history.detail)의 요청 본문을 만듭니다.
순번변수명타입설명
successboolean요청 처리 성공 여부
pageobject화면 페이지 메타 객체
formsarrayform 메타데이터 배열
fieldsarray입력 필드 계약 배열
semantic_fieldsarray의미 단위 입력 컨트롤 배열
semantic_payloadobject의미 필드 키-값 맵
semantic_field_countnumber의미 필드 개수
csrf_token_presentbooleanCSRF 토큰 존재 여부
followup_endpointsarray기관 화면이 다음 단계에서 부르는 주소 목록({url} 객체 배열)입니다. 우리 API 주소가 아니며 직접 호출하지 않습니다
raw_html_lennumber원본 HTML 길이
source_urlstring서버가 요청한 기관 화면 주소
json
// result.data
{
  "success": true,
  "page": {},
  "forms": [],
  "fields": [],
  "semantic_fields": [],
  "semantic_payload": {},
  "semantic_field_count": 1,
  "csrf_token_present": true,
  "followup_endpoints": [],
  "raw_html_len": 0,
  "source_url": "..."
}
순번오류 코드발생 조건
AUTH_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.
PROVIDER_AUTH_FAILED인증 만료 — 인증이 만료됐습니다. 로그인을 다시 호출합니다.
PROVIDER_UPSTREAM_ERROR업스트림 오류 — 기관 연결 실패, 응답 없음, 오류 응답, 읽을 수 없는 응답입니다. error.message 안내대로 잠시 후 다시 호출하거나 보낸 값과 연동 계정 권한을 확인합니다.
VALIDATION_INVALID_FIELD필수 칸 누락 — 필수 칸(cvrc_no)이 비어 있어 기관을 부르기 전에 거절했습니다. error.message 가 빠진 칸 이름을 알려 줍니다. 재시도 불가로 표시되니 그 칸을 채워 다시 호출합니다.

5. 증명서 신청이력 목록 조회fourinsure.b1.certificate.history.list

MCP 도구 이름 fourinsure__b1__certificate__history__list

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

조건 없이 부르면 증명서 신청이력 화면 첫 쪽에 보이는 신청 건마다 접수번호, 증명서 종류, 접수일시, 처리 상태, 출력 가능 여부를 돌려줍니다.

  • 조회 결과가 없으면 items 가 빈 배열로 옵니다. 실패가 아닙니다.
  • params 는 빈 객체로 보내도 호출됩니다. 사용할 인증서는 account_link_id 로 지정합니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • fourinsure이 API 고정값 (기본값)

예시 : fourinsure

actionstring-Y호출할 작업입니다.
  • fourinsure.b1.certificate.history.list이 API 고정값 (기본값)

예시 : fourinsure.b1.certificate.history.list

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-N작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

추가 파라미터가 없습니다. params 는 {} 로 보냅니다.

bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: list-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "fourinsure",
  "action": "fourinsure.b1.certificate.history.list",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • result.data 의 items 로 조회 결과를 확인합니다.
순번변수명타입설명
successboolean요청 처리 성공 여부
itemsarray조회 결과 행 배열
source_urlstring서버가 요청한 기관 화면 주소
json
// result.data
{
  "success": true,
  "items": [
    {
      "row_no": 0,
      "cvrc_no": "...",
      "workplace": "...",
      "request_type": "...",
      "received_at": "2026-06-15",
      "status": "...",
      "status_code": "...",
      "print_available": true,
      "pdf_download_available": true
    }
  ],
  "source_url": "..."
}
순번오류 코드발생 조건
AUTH_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.
PROVIDER_AUTH_FAILED인증 만료 — 인증이 만료됐습니다. 로그인을 다시 호출합니다.
PROVIDER_UPSTREAM_ERROR업스트림 오류 — 기관 연결 실패, 응답 없음, 오류 응답, 읽을 수 없는 응답입니다. error.message 안내대로 잠시 후 다시 호출하거나 보낸 값과 연동 계정 권한을 확인합니다.

6. 증명서 신청이력 목록 입력 서식 조회fourinsure.b1.certificate.history.list_init

MCP 도구 이름 fourinsure__b1__certificate__history__list_init

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

로그인한 연동 계정으로 증명서 신청이력 목록 화면을 열어 접수번호, 그룹 접수번호, 쪽 번호 칸과 상세 화면 주소를 돌려줍니다.

  • params 는 빈 객체로 보내도 호출됩니다. 사용할 인증서는 account_link_id 로 지정합니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • fourinsure이 API 고정값 (기본값)

예시 : fourinsure

actionstring-Y호출할 작업입니다.
  • fourinsure.b1.certificate.history.list_init이 API 고정값 (기본값)

예시 : fourinsure.b1.certificate.history.list_init

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-N작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

추가 파라미터가 없습니다. params 는 {} 로 보냅니다.

bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: list_init-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "fourinsure",
  "action": "fourinsure.b1.certificate.history.list_init",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • result.data 에서 입력 항목(fields)과 화면 정보를 확인해 다음 단계(fourinsure.b1.certificate.history.list)의 요청 본문을 만듭니다.
순번변수명타입설명
successboolean요청 처리 성공 여부
pageobject화면 페이지 메타 객체
formsarrayform 메타데이터 배열
fieldsarray입력 필드 계약 배열
semantic_fieldsarray의미 단위 입력 컨트롤 배열
semantic_payloadobject의미 필드 키-값 맵
semantic_field_countnumber의미 필드 개수
csrf_token_presentbooleanCSRF 토큰 존재 여부
followup_endpointsarray기관 화면이 다음 단계에서 부르는 주소 목록({url} 객체 배열)입니다. 우리 API 주소가 아니며 직접 호출하지 않습니다
raw_html_lennumber원본 HTML 길이
source_urlstring서버가 요청한 기관 화면 주소
json
// result.data
{
  "success": true,
  "page": {},
  "forms": [],
  "fields": [],
  "semantic_fields": [],
  "semantic_payload": {},
  "semantic_field_count": 1,
  "csrf_token_present": true,
  "followup_endpoints": [],
  "raw_html_len": 0,
  "source_url": "..."
}
순번오류 코드발생 조건
AUTH_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.
PROVIDER_AUTH_FAILED인증 만료 — 인증이 만료됐습니다. 로그인을 다시 호출합니다.
PROVIDER_UPSTREAM_ERROR업스트림 오류 — 기관 연결 실패, 응답 없음, 오류 응답, 읽을 수 없는 응답입니다. error.message 안내대로 잠시 후 다시 호출하거나 보낸 값과 연동 계정 권한을 확인합니다.

7. 증명서 신청이력 PDF 다운로드fourinsure.b1.certificate.history.pdf_download

MCP 도구 이름 fourinsure__b1__certificate__history__pdf_download

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

출력가능 상태인 증명서 신청 건의 PDF 를 받는 상품입니다.

  • 기본은 dry_run=true 로 대상만 확인합니다. 실제로 받으려면 dry_run 을 false, confirm_download 를 true 로 보냅니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • fourinsure이 API 고정값 (기본값)

예시 : fourinsure

actionstring-Y호출할 작업입니다.
  • fourinsure.b1.certificate.history.pdf_download이 API 고정값 (기본값)

예시 : fourinsure.b1.certificate.history.pdf_download

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-N작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입필수설명
cvrc_nostringN대상 민원번호 cvrcNo. 미입력 시 download_all_available로 목록에서 선택
group_cvrc_nostringN그룹 민원번호 groupCvrcNo. 기본 ""
download_all_availablebooleanNtrue면 출력가능 전체 행 대상. cvrc_no 미지정 시 사용
confirm_downloadbooleanNtrue일 때만 MarkAny PDF export 수행. dry_run=false 시 필수
dry_runbooleanNtrue면 PDF export 없이 대상·payload만 검증. 기본 true
mark_printedbooleanN기본 true. 증명서 PDF 를 받은 뒤 기관 발급 이력에 출력 처리 표시를 남깁니다. 남기지 않으려면 false 를 입력합니다
pdf_file_namestringN저장 파일명 힌트 (pdfFileNm)
pdf_file_passwordstringNPDF 파일 비밀번호 (pdfFilePw)
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: pdf_download-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "fourinsure",
  "action": "fourinsure.b1.certificate.history.pdf_download",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • result.data 의 downloaded_count 와 items(행마다 downloaded)로 결과를 확인하고, 받은 PDF 는 result.artifacts 에 파일마다 download_url 과 함께 옵니다.
  • 일부 건이 실패하면 result.data 의 success 가 false 이고 failed_count 가 0 보다 크며, message_ko 에 안내가 옵니다.
  • 실패한 건마다 items 의 error_code 와 error_message 에 이유가 있고, 모두 출력할 수 없는 상태 때문이면 result.data 에도 error_code(cerf_pdf_not_print_available)가 옵니다.
순번변수명타입설명
successboolean요청 처리 성공 여부
dry_runboolean접수 없이 검증만 한 호출이면 true
confirm_downloadboolean다운로드 확인 플래그
requested_countnumber요청 건수
downloaded_countnumber다운로드 완료 건수
succeeded_countnumber성공한 건수(dry_run 이면 내려받지 않아도 성공이면 셉니다)
failed_countnumber실패한 건수(requested_count 에서 succeeded_count 를 뺀 값)
itemsarray조회 결과 행 배열
source_urlstring서버가 요청한 기관 화면 주소
message_kostring | null일부 건이 실패했을 때만 옵니다 - 무엇이 안 됐고 다음에 무엇을 하면 되는지 알려 주는 안내 문장
error_codestring | null실패한 건이 모두 출력할 수 없는 상태 때문일 때만 옵니다(이유가 섞이면 오지 않고 items 의 건마다 error_code 로 봅니다)
json
// result.data
{
  "success": true,
  "dry_run": false,
  "confirm_download": true,
  "requested_count": 1,
  "downloaded_count": 1,
  "succeeded_count": 1,
  "failed_count": 0,
  "items": [
    {
      "success": true,
      "downloaded": true,
      "dry_run": false,
      "cvrc_no": "...",
      "request_type": "...",
      "received_at": "2026-06-15",
      "process_agencies": [],
      "statuses": [],
      "issued_at": "2026-06-15",
      "status_code": "...",
      "print_button_present": true,
      "print_available": true,
      "pdf_download_available": true,
      "issu_no": "...",
      "list_row": {},
      "error_code": null,
      "error_message": null,
      "source_url": "..."
    }
  ],
  "source_url": "..."
}
순번오류 코드발생 조건
AUTH_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.
PROVIDER_AUTH_FAILED인증 만료 — 인증이 만료됐습니다. 로그인을 다시 호출합니다.
PROVIDER_UPSTREAM_ERROR기관 통신 오류 — 기관이 오류로 답하거나 연결이 끊겨 PDF 요청이 처리됐는지 알 수 없을 수 있으니, 다시 요청하기 전에 증명서 신청이력 목록 조회로 그 신청의 처리 상태와 출력 가능 여부를 먼저 확인합니다. 기관이 오류 응답을 보내거나 응답이 오지 않거나 연결이 끊긴 경우 error.message 는 결과 확인 불가 안내('기관의 요청 처리 여부를 확인하지 못했습니다. 다시 실행하지 마세요. 이미 처리됐을 수 있어 중복 처리로 이어집니다.')입니다.
PROVIDER_VALIDATION_ERROR검증 오류 — 보낸 값이 빠졌거나 형식이 맞지 않거나 값에 맞는 대상을 찾지 못한 경우입니다. error.message 가 알려 주는 값을 고쳐 다시 호출합니다.
PROVIDER_VALIDATION_ERROR출력할 건 없음 — 출력할 수 있는 증명서가 없습니다. 증명서 신청 이력에서 처리상태가 출력가능인 건을 골라 주세요.

8. 증명서 발급사실 확인fourinsure.b1.certificate.issue_fact.confirm

MCP 도구 이름 fourinsure__b1__certificate__issue_fact__confirm

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

발급번호로 증명서가 발급된 사실이 있는지와 발급일자, 발급처, 기관 안내 문구를 돌려줍니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • fourinsure이 API 고정값 (기본값)

예시 : fourinsure

actionstring-Y호출할 작업입니다.
  • fourinsure.b1.certificate.issue_fact.confirm이 API 고정값 (기본값)

예시 : fourinsure.b1.certificate.issue_fact.confirm

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-Y작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입필수설명
join_kind_cdstringY증명서 종류 joinKindCd. 0/2/3=사업장(bpmno 필수), 1=가입자(idnty_nm·frnt_rrno 필수)
issu_nostringY발급번호 issuNo (숫자만 추출)
bpmnostringN사업장관리번호 11자리. join_kind_cd 0/2/3 시 필수
idnty_nmstringN가입자 성명. join_kind_cd 1 시 필수
frnt_rrnostringN주민번호 앞 6자리. join_kind_cd 1 시 필수
  • 「<필수>」 자리는 예시 값이 없는 필수 칸입니다. 위 파라미터 표를 보고 실제 값으로 바꿔 보냅니다.
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: confirm-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "fourinsure",
  "action": "fourinsure.b1.certificate.issue_fact.confirm",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "join_kind_cd": "<필수>",
    "issu_no": "<필수>"
  }
}'

Response

  • result.data 의 verified 로 발급 사실이 확인됐는지 봅니다. 판정 내용은 status_code 와 message 에 담깁니다.
순번변수명타입설명
successboolean요청 처리 성공 여부
verifiedboolean발급사실 검증 결과
status_codestring상태 코드
requested_join_kind_cdstring요청 가입종류 코드
submitted_join_kind_cdstring제출 가입종류 코드
input_modestring입력 모드
document_typestring문서 유형
titlestring화면/결과 제목
messagestring결과 메시지
issu_nostring발급번호
bpmnostring | null사업장관리번호
issued_datestring발급일
issued_date_textstring발급일 표시 텍스트
issuerstring발급 기관
submitted_payloadobject제출 payload 맵
csrf_token_presentbooleanCSRF 토큰 존재 여부
raw_html_lennumber원본 HTML 길이
source_urlstring서버가 요청한 기관 화면 주소
json
// result.data
{
  "success": true,
  "verified": true,
  "status_code": "ISSUED",
  "requested_join_kind_cd": "...",
  "submitted_join_kind_cd": "...",
  "input_mode": "...",
  "document_type": "...",
  "title": "...",
  "message": "...",
  "issu_no": "...",
  "bpmno": "...",
  "issued_date": "2026-06-15",
  "issued_date_text": "2026년 06월 15일",
  "issuer": "...",
  "submitted_payload": {},
  "csrf_token_present": true,
  "raw_html_len": 0,
  "source_url": "..."
}
순번오류 코드발생 조건
AUTH_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.
PROVIDER_AUTH_FAILED인증 만료 — 인증이 만료됐습니다. 로그인을 다시 호출합니다.
PROVIDER_UPSTREAM_ERROR업스트림 오류 — 기관 연결 실패, 응답 없음, 오류 응답, 읽을 수 없는 응답입니다. error.message 안내대로 잠시 후 다시 호출하거나 보낸 값과 연동 계정 권한을 확인합니다.
VALIDATION_INVALID_FIELD필수 칸 누락 — 필수 칸(join_kind_cd, issu_no)이 비어 있어 기관을 부르기 전에 거절했습니다. error.message 가 빠진 칸 이름을 알려 줍니다. 재시도 불가로 표시되니 그 칸을 채워 다시 호출합니다.
PROVIDER_VALIDATION_ERROR검증 오류 — 보낸 값이 빠졌거나 형식이 맞지 않거나 값에 맞는 대상을 찾지 못한 경우입니다. error.message 가 알려 주는 값을 고쳐 다시 호출합니다.