증명서 - 4대보험
이 쪽의 모든 작업에 해당
- 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [4대보험 로그인]
1. 증명서 신청/발급 입력 서식 조회fourinsure. b1. certificate. apply. init
MCP 도구 이름 fourinsure__
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
로그인한 연동 계정의 증명서 신청 화면을 읽어 증명서 종류와 출력 순서 보기, 전화번호 칸, 미리 채워진 사업장 정보를 돌려줍니다.
- params 는 빈 객체로 보내도 호출됩니다. 사용할 인증서는 account_link_id 로 지정합니다.
Request
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. | |
| X- | Y | 호출 환경입니다.
| |
| Idempotency- | Y | 재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. | |
| Content- | Y | 요청 본문 형식입니다.
| |
| X- | N | 추적 아이디입니다. 지정하지 않으면 서버가 발급합니다. |
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| provider | string | - | Y | 호출할 기관입니다.
| |
| action | string | - | Y | 호출할 작업입니다.
| |
| account_ | string | 36 | 조건부 | 등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | N | 작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
추가 파라미터가 없습니다. params 는 {} 로 보냅니다.
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)의 요청 본문을 만듭니다.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| success | boolean | 요청 처리 성공 여부 | |
| page | object | 화면 페이지 메타 객체 | |
| forms | array | form 메타데이터 배열 | |
| fields | array | 입력 필드 계약 배열 | |
| semantic_ | array | 의미 단위 입력 컨트롤 배열 | |
| semantic_ | object | 의미 필드 키-값 맵 | |
| semantic_ | number | 의미 필드 개수 | |
| csrf_ | boolean | CSRF 토큰 존재 여부 | |
| followup_ | array | 기관 화면이 다음 단계에서 부르는 주소 목록({url} 객체 배열)입니다. 우리 API 주소가 아니며 직접 호출하지 않습니다 | |
| navigation_ | array | 화면 내비게이션 단계 배열 | |
| current_ | string | 현재 화면 식별자 | |
| target_ | boolean | 대상 폼 준비 여부 | |
| raw_ | number | 원본 HTML 길이 | |
| source_ | string | 서버가 요청한 기관 화면 주소 |
// 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_ | 세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다. | |
| PROVIDER_ | 인증 만료 — 인증이 만료됐습니다. 로그인을 다시 호출합니다. | |
| PROVIDER_ | 업스트림 오류 — 기관 연결 실패, 응답 없음, 오류 응답, 읽을 수 없는 응답입니다. error.message 안내대로 잠시 후 다시 호출하거나 보낸 값과 연동 계정 권한을 확인합니다. |
2. 증명서 신청/발급 제출fourinsure. b1. certificate. apply. submit
MCP 도구 이름 fourinsure__
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
사업장 가입내역 확인서와 가입자 명부 중 신청할 증명서를 기관에 제출하고 접수번호를 받습니다.
- 요청 거절(HTTP 400, 작업은 만들어지지 않음).error.code=WRITE_CONFIRMATION_REQUIRED — confirmation_token 없이 부르면 신청을 접수하지 않고 이 오류로 끝납니다.dry_run 을 true 로(또는 confirm_submit 을 false 로) 보내 접수 없이 확인만 할 때도 같습니다.error.message 에 확인할 내용이, error.confirmation_token 에 1회용 토큰이, error.preview 에 접수할 내용과 되돌릴 수 없다는 안내가 함께 옵니다.안내를 사용자에게 보여 주고 동의를 받은 뒤 같은 요청의 params.confirmation_token 에 그 토큰을 넣어 다시 보냅니다. 토큰은 10분 안에 한 번만 쓸 수 있고 처음 요청과 같은 본문에만 맞습니다.confirm 칸은 확인으로 쓰이지 않으며, 다시 보낼 때 더하면 본문이 달라져 확인 토큰 불일치로 끝납니다.
- 요청 거절(HTTP 409, 작업은 만들어지지 않음).error.code=WRITE_CONFIRMATION_INVALID — 토큰이 만료됐거나, 이미 썼거나, 다른 호출자나 다른 환경에서 받은 것이거나, 확인한 요청 본문과 달라졌으면 신청을 접수하지 않고 이 오류로 끝나며 어느 쪽인지는 알려 주지 않습니다.error.message 는 「확인이 만료됐거나 확인한 내용과 달라졌습니다. 다시 확인해 주세요.」 입니다. confirmation_token 없이 같은 요청을 다시 보내 새 토큰과 안내를 받은 뒤 사용자에게 다시 확인을 받습니다.
- 되돌릴 수 없는 접수라 사용자 동의를 1회용 확인 토큰으로 받습니다(위 확인 토큰 필요 행).confirm 칸은 보내지 않습니다. dry_run 을 true 로(또는 confirm_submit 을 false 로) 보내면 접수 없이 검증만 합니다.
Request
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. | |
| X- | Y | 호출 환경입니다.
| |
| Idempotency- | Y | 재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. | |
| Content- | Y | 요청 본문 형식입니다.
| |
| X- | N | 추적 아이디입니다. 지정하지 않으면 서버가 발급합니다. |
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| provider | string | - | Y | 호출할 기관입니다.
| |
| action | string | - | Y | 호출할 작업입니다.
| |
| account_ | string | 36 | 조건부 | 등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | Y | 작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
| 순번 | 변수명 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
| selection | string | Y | 증명서 종류. 2=사업장 가입내역확인서, 3=사업장 가입자명부. 별칭은 document_type 입니다 | |
| output_ | string | N | 출력 정렬 otptSortSeCd. 1=이름순, 2=주민등록순. 기본 1 | |
| phone_ | string | N | 연락처 지역번호 idntyTrprTelrno | |
| phone_ | string | N | 연락처 국번호 idntyTrprTelono | |
| phone_ | string | N | 연락처 끝번호 idntyTrprTelino | |
| confirm | boolean | N | 지금은 쓰지 않는 값입니다. 보내지 않습니다. 제출 동의는 1회용 확인 토큰(confirmation_token)으로 받습니다 | |
| confirm_ | boolean | N | 실제로 제출할지 정하는 값입니다. 보내지 않으면 true 입니다. false 로 보내면 기관에 제출하지 않고 입력값만 확인하며, 응답의 submitted 가 false 입니다. 제출 동의는 이 값이 아니라 1회용 확인 토큰(confirmation_token)으로 받습니다 | |
| dry_ | boolean | N | true 로 보내면 기관에 제출하지 않고 입력값만 확인합니다. 보내지 않으면 false 입니다. 응답의 submitted 는 false, dry_run 은 true 이며 confirm_submit 을 false 로 보낸 것과 같습니다 | |
| confirmation_ | string | N | 1회용 확인 토큰입니다. 처음에는 보내지 않습니다. 토큰 없이 부르면 기관에 아무것도 보내지 않고 작업도 만들지 않은 채 확인이 필요하다는 오류(WRITE_CONFIRMATION_REQUIRED)로 끝나고, 응답의 error.confirmation_token 에 토큰이 옵니다. error.message 의 안내를 사용자에게 보여 주고 동의를 받은 뒤 같은 요청에 이 토큰을 넣어 다시 부릅니다. 토큰은 10분 안에 한 번만 쓸 수 있고 처음 요청과 같은 본문, 같은 호출자, 같은 환경에서만 맞으며, 아니면 확인이 만료됐거나 내용이 달라졌다는 오류로 거절합니다 |
- 「<필수>」 자리는 예시 값이 없는 필수 칸입니다. 위 파라미터 표를 보고 실제 값으로 바꿔 보냅니다.
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 면 접수하지 않은 검증 결과입니다.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| success | boolean | 요청 처리 성공 여부 | |
| submitted | boolean | 실제 제출 수행 여부 | |
| dry_ | boolean | 접수 없이 검증만 한 호출이면 true | |
| selection | string | 선택한 증명서 종류 | |
| join_ | string | 가입내역확인서 종류 코드 | |
| output_ | string | 출력 정렬 코드 | |
| cvrc_ | string | null | 증명서 접수번호 | |
| request_ | string | 신청 유형 | |
| received_ | string | 접수 일시 | |
| process_ | array | 처리 기관 배열 | |
| statuses | array | 처리 상태 배열 | |
| issued_ | string | null | 발급 일시 | |
| form_ | object | hidden form 필드 맵 | |
| navigation_ | array | 화면 내비게이션 단계 배열 | |
| source_ | string | 서버가 요청한 기관 화면 주소 | |
| raw_ | number | 원본 HTML 길이 | |
| status_ | string | 출력 상태를 하나로 요약한 코드입니다. 접수까지 실제로 한 결과(submitted 가 true)에만 옵니다. | |
| print_ | boolean | 제출한 신청의 상세 화면에 인쇄 버튼이 있는지 여부입니다. submitted 가 true 일 때만 옵니다. | |
| print_ | boolean | 지금 인쇄할 수 있는지 여부입니다(출력 상태가 인쇄 가능이고 인쇄 버튼이 있을 때 true). submitted 가 true 일 때만 옵니다. | |
| pdf_ | boolean | 지금 PDF 로 내려받을 수 있는지 여부입니다(인쇄 가능 여부와 같은 값). submitted 가 true 일 때만 옵니다. | |
| outcome | string | 접수 판정입니다. 기관이 매긴 접수번호를 읽었으면 confirmed 입니다. 읽지 못하면 작업 API 는 결과 대신 실패(error_code PROVIDER_OUTCOME_UNCONFIRMED, 재시도 불가)로 끝나고, REST 응답은 이 칸이 unconfirmed 이고 success 가 false 입니다. submitted 가 true 일 때만 값이 있습니다. | |
| message_ | string | REST 응답에서 outcome 이 unconfirmed 일 때만 값이 있는 안내 문장입니다. 작업 API 는 이 문장을 실패의 오류 문장 앞부분으로 줍니다. | |
| how_ | string | REST 응답에서 outcome 이 unconfirmed 일 때만 값이 있습니다. 다시 신청하기 전에 신청 이력에서 방금 신청이 접수됐는지 확인하는 방법을 알려 줍니다. 작업 API 는 이 문장을 실패의 오류 문장 뒤에 붙여 줍니다. | |
| action | string | 작업 API 결과에만 있는 칸입니다. 접수를 확인했을 때 이 액션 이름이 그대로 옵니다. REST 응답에는 없습니다. submitted 가 true 일 때만 옵니다. |
// 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_ | 세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다. | |
| PROVIDER_ | 인증 만료 — 인증이 만료됐습니다. 로그인을 다시 호출합니다. | |
| PROVIDER_ | 처리 확인 불가 — 기관이 오류로 답하거나 연결이 끊겨 신청이 접수됐는지 알 수 없을 수 있으니, 다시 신청하지 말고 증명서 신청이력 목록 조회로 방금 낸 신청이 있는지 먼저 확인합니다. 기관이 오류 응답을 보내거나 응답이 오지 않거나 연결이 끊긴 경우 error.message 는 결과 확인 불가 안내('기관의 요청 처리 여부를 확인하지 못했습니다. 다시 실행하지 마세요. 이미 처리됐을 수 있어 중복 처리로 이어집니다.')입니다. | |
| PROVIDER_ | 처리 확인 불가 — 기관이 오류로 답하거나 연결이 끊겨 신청이 접수됐는지 알 수 없을 수 있으니, 다시 신청하지 말고 증명서 신청이력 목록 조회로 방금 낸 신청이 있는지 먼저 확인합니다. 기관이 오류 응답을 보내거나 응답이 오지 않거나 연결이 끊긴 경우 error.message 는 결과 확인 불가 안내('기관의 요청 처리 여부를 확인하지 못했습니다. 다시 실행하지 마세요. 이미 처리됐을 수 있어 중복 처리로 이어집니다.')입니다. | |
| PROVIDER_ | 검증 오류 — 보낸 값이 빠졌거나 형식이 맞지 않거나 값에 맞는 대상을 찾지 못한 경우입니다. error.message 가 알려 주는 값을 고쳐 다시 호출합니다. |
3. 증명서 신청이력 상세 조회fourinsure. b1. certificate. history. detail
MCP 도구 이름 fourinsure__
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
접수번호 하나로 증명서 신청 건의 상세를 열어 접수일시, 처리 기관마다의 상태, 발급일자, 출력 가능 여부를 받습니다.
Request
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. | |
| X- | Y | 호출 환경입니다.
| |
| Idempotency- | Y | 재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. | |
| Content- | Y | 요청 본문 형식입니다.
| |
| X- | N | 추적 아이디입니다. 지정하지 않으면 서버가 발급합니다. |
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| provider | string | - | Y | 호출할 기관입니다.
| |
| action | string | - | Y | 호출할 작업입니다.
| |
| account_ | string | 36 | 조건부 | 등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | Y | 작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
| 순번 | 변수명 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
| cvrc_ | string | Y | 증명서 신청이력 상세 조회용 민원번호 cvrcNo | |
| group_ | string | N | 그룹 민원번호 groupCvrcNo. 기본 "" |
- 「<필수>」 자리는 예시 값이 없는 필수 칸입니다. 위 파라미터 표를 보고 실제 값으로 바꿔 보냅니다.
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 를 받을 수 있는지 확인합니다.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| success | boolean | 요청 처리 성공 여부 | |
| cvrc_ | string | 증명서 접수번호 | |
| request_ | string | 신청 유형 | |
| received_ | string | 접수 일시 | |
| process_ | array | 처리 기관 배열 | |
| statuses | array | 처리 상태 배열 | |
| issued_ | string | null | 발급 일시 | |
| status_ | string | 상태 코드 | |
| print_ | boolean | 인쇄 버튼 존재 여부 | |
| print_ | boolean | 인쇄 가능 여부 | |
| pdf_ | boolean | PDF 다운로드 가능 여부 | |
| form_ | object | hidden form 필드 맵 | |
| source_ | string | 서버가 요청한 기관 화면 주소 |
// 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_ | 세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다. | |
| PROVIDER_ | 인증 만료 — 인증이 만료됐습니다. 로그인을 다시 호출합니다. | |
| PROVIDER_ | 업스트림 오류 — 기관 연결 실패, 응답 없음, 오류 응답, 읽을 수 없는 응답입니다. error.message 안내대로 잠시 후 다시 호출하거나 보낸 값과 연동 계정 권한을 확인합니다. | |
| VALIDATION_ | 필수 칸 누락 — 필수 칸(cvrc_no)이 비어 있어 기관을 부르기 전에 거절했습니다. error.message 가 빠진 칸 이름을 알려 줍니다. 재시도 불가로 표시되니 그 칸을 채워 다시 호출합니다. |
4. 증명서 신청이력 상세 입력 서식 조회fourinsure. b1. certificate. history. detail_ init
MCP 도구 이름 fourinsure__
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
증명서 신청이력 목록 조회에서 받은 접수번호를 넣으면 그 건 상세 화면의 출력 양식 칸과 출력 처리 주소를 돌려줍니다.
Request
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. | |
| X- | Y | 호출 환경입니다.
| |
| Idempotency- | Y | 재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. | |
| Content- | Y | 요청 본문 형식입니다.
| |
| X- | N | 추적 아이디입니다. 지정하지 않으면 서버가 발급합니다. |
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| provider | string | - | Y | 호출할 기관입니다.
| |
| action | string | - | Y | 호출할 작업입니다.
| |
| account_ | string | 36 | 조건부 | 등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | Y | 작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
| 순번 | 변수명 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
| cvrc_ | string | Y | 증명서 신청이력 상세 조회용 민원번호 cvrcNo | |
| group_ | string | N | 그룹 민원번호 groupCvrcNo. 기본 "" |
- 「<필수>」 자리는 예시 값이 없는 필수 칸입니다. 위 파라미터 표를 보고 실제 값으로 바꿔 보냅니다.
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)의 요청 본문을 만듭니다.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| success | boolean | 요청 처리 성공 여부 | |
| page | object | 화면 페이지 메타 객체 | |
| forms | array | form 메타데이터 배열 | |
| fields | array | 입력 필드 계약 배열 | |
| semantic_ | array | 의미 단위 입력 컨트롤 배열 | |
| semantic_ | object | 의미 필드 키-값 맵 | |
| semantic_ | number | 의미 필드 개수 | |
| csrf_ | boolean | CSRF 토큰 존재 여부 | |
| followup_ | array | 기관 화면이 다음 단계에서 부르는 주소 목록({url} 객체 배열)입니다. 우리 API 주소가 아니며 직접 호출하지 않습니다 | |
| raw_ | number | 원본 HTML 길이 | |
| source_ | string | 서버가 요청한 기관 화면 주소 |
// 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_ | 세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다. | |
| PROVIDER_ | 인증 만료 — 인증이 만료됐습니다. 로그인을 다시 호출합니다. | |
| PROVIDER_ | 업스트림 오류 — 기관 연결 실패, 응답 없음, 오류 응답, 읽을 수 없는 응답입니다. error.message 안내대로 잠시 후 다시 호출하거나 보낸 값과 연동 계정 권한을 확인합니다. | |
| VALIDATION_ | 필수 칸 누락 — 필수 칸(cvrc_no)이 비어 있어 기관을 부르기 전에 거절했습니다. error.message 가 빠진 칸 이름을 알려 줍니다. 재시도 불가로 표시되니 그 칸을 채워 다시 호출합니다. |
5. 증명서 신청이력 목록 조회fourinsure. b1. certificate. history. list
MCP 도구 이름 fourinsure__
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
조건 없이 부르면 증명서 신청이력 화면 첫 쪽에 보이는 신청 건마다 접수번호, 증명서 종류, 접수일시, 처리 상태, 출력 가능 여부를 돌려줍니다.
- 조회 결과가 없으면 items 가 빈 배열로 옵니다. 실패가 아닙니다.
- params 는 빈 객체로 보내도 호출됩니다. 사용할 인증서는 account_link_id 로 지정합니다.
Request
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. | |
| X- | Y | 호출 환경입니다.
| |
| Idempotency- | Y | 재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. | |
| Content- | Y | 요청 본문 형식입니다.
| |
| X- | N | 추적 아이디입니다. 지정하지 않으면 서버가 발급합니다. |
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| provider | string | - | Y | 호출할 기관입니다.
| |
| action | string | - | Y | 호출할 작업입니다.
| |
| account_ | string | 36 | 조건부 | 등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | N | 작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
추가 파라미터가 없습니다. params 는 {} 로 보냅니다.
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 로 조회 결과를 확인합니다.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| success | boolean | 요청 처리 성공 여부 | |
| items | array | 조회 결과 행 배열 | |
| source_ | string | 서버가 요청한 기관 화면 주소 |
// 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_ | 세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다. | |
| PROVIDER_ | 인증 만료 — 인증이 만료됐습니다. 로그인을 다시 호출합니다. | |
| PROVIDER_ | 업스트림 오류 — 기관 연결 실패, 응답 없음, 오류 응답, 읽을 수 없는 응답입니다. error.message 안내대로 잠시 후 다시 호출하거나 보낸 값과 연동 계정 권한을 확인합니다. |
6. 증명서 신청이력 목록 입력 서식 조회fourinsure. b1. certificate. history. list_ init
MCP 도구 이름 fourinsure__
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
로그인한 연동 계정으로 증명서 신청이력 목록 화면을 열어 접수번호, 그룹 접수번호, 쪽 번호 칸과 상세 화면 주소를 돌려줍니다.
- params 는 빈 객체로 보내도 호출됩니다. 사용할 인증서는 account_link_id 로 지정합니다.
Request
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. | |
| X- | Y | 호출 환경입니다.
| |
| Idempotency- | Y | 재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. | |
| Content- | Y | 요청 본문 형식입니다.
| |
| X- | N | 추적 아이디입니다. 지정하지 않으면 서버가 발급합니다. |
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| provider | string | - | Y | 호출할 기관입니다.
| |
| action | string | - | Y | 호출할 작업입니다.
| |
| account_ | string | 36 | 조건부 | 등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | N | 작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
추가 파라미터가 없습니다. params 는 {} 로 보냅니다.
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)의 요청 본문을 만듭니다.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| success | boolean | 요청 처리 성공 여부 | |
| page | object | 화면 페이지 메타 객체 | |
| forms | array | form 메타데이터 배열 | |
| fields | array | 입력 필드 계약 배열 | |
| semantic_ | array | 의미 단위 입력 컨트롤 배열 | |
| semantic_ | object | 의미 필드 키-값 맵 | |
| semantic_ | number | 의미 필드 개수 | |
| csrf_ | boolean | CSRF 토큰 존재 여부 | |
| followup_ | array | 기관 화면이 다음 단계에서 부르는 주소 목록({url} 객체 배열)입니다. 우리 API 주소가 아니며 직접 호출하지 않습니다 | |
| raw_ | number | 원본 HTML 길이 | |
| source_ | string | 서버가 요청한 기관 화면 주소 |
// 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_ | 세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다. | |
| PROVIDER_ | 인증 만료 — 인증이 만료됐습니다. 로그인을 다시 호출합니다. | |
| PROVIDER_ | 업스트림 오류 — 기관 연결 실패, 응답 없음, 오류 응답, 읽을 수 없는 응답입니다. error.message 안내대로 잠시 후 다시 호출하거나 보낸 값과 연동 계정 권한을 확인합니다. |
7. 증명서 신청이력 PDF 다운로드fourinsure. b1. certificate. history. pdf_ download
MCP 도구 이름 fourinsure__
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
출력가능 상태인 증명서 신청 건의 PDF 를 받는 상품입니다.
- 기본은 dry_run=true 로 대상만 확인합니다. 실제로 받으려면 dry_run 을 false, confirm_download 를 true 로 보냅니다.
Request
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. | |
| X- | Y | 호출 환경입니다.
| |
| Idempotency- | Y | 재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. | |
| Content- | Y | 요청 본문 형식입니다.
| |
| X- | N | 추적 아이디입니다. 지정하지 않으면 서버가 발급합니다. |
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| provider | string | - | Y | 호출할 기관입니다.
| |
| action | string | - | Y | 호출할 작업입니다.
| |
| account_ | string | 36 | 조건부 | 등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | N | 작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
| 순번 | 변수명 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
| cvrc_ | string | N | 대상 민원번호 cvrcNo. 미입력 시 download_all_available로 목록에서 선택 | |
| group_ | string | N | 그룹 민원번호 groupCvrcNo. 기본 "" | |
| download_ | boolean | N | true면 출력가능 전체 행 대상. cvrc_no 미지정 시 사용 | |
| confirm_ | boolean | N | true일 때만 MarkAny PDF export 수행. dry_run=false 시 필수 | |
| dry_ | boolean | N | true면 PDF export 없이 대상·payload만 검증. 기본 true | |
| mark_ | boolean | N | 기본 true. 증명서 PDF 를 받은 뒤 기관 발급 이력에 출력 처리 표시를 남깁니다. 남기지 않으려면 false 를 입력합니다 | |
| pdf_ | string | N | 저장 파일명 힌트 (pdfFileNm) | |
| pdf_ | string | N | PDF 파일 비밀번호 (pdfFilePw) |
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 과 함께 옵니다.dry_run 이 true 면 대상만 확인한 결과입니다.
- 일부 건이 실패하면 result.data 의 success 가 false 이고 failed_count 가 0 보다 크며, message_ko 에 안내가 옵니다.
- 실패한 건마다 items 의 error_code 와 error_message 에 이유가 있고, 모두 출력할 수 없는 상태 때문이면 result.data 에도 error_code(cerf_pdf_not_print_available)가 옵니다.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| success | boolean | 요청 처리 성공 여부 | |
| dry_ | boolean | 접수 없이 검증만 한 호출이면 true | |
| confirm_ | boolean | 다운로드 확인 플래그 | |
| requested_ | number | 요청 건수 | |
| downloaded_ | number | 다운로드 완료 건수 | |
| succeeded_ | number | 성공한 건수(dry_run 이면 내려받지 않아도 성공이면 셉니다) | |
| failed_ | number | 실패한 건수(requested_count 에서 succeeded_count 를 뺀 값) | |
| items | array | 조회 결과 행 배열 | |
| source_ | string | 서버가 요청한 기관 화면 주소 | |
| message_ | string | null | 일부 건이 실패했을 때만 옵니다 - 무엇이 안 됐고 다음에 무엇을 하면 되는지 알려 주는 안내 문장 | |
| error_ | string | null | 실패한 건이 모두 출력할 수 없는 상태 때문일 때만 옵니다(이유가 섞이면 오지 않고 items 의 건마다 error_code 로 봅니다) |
// 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_ | 세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다. | |
| PROVIDER_ | 인증 만료 — 인증이 만료됐습니다. 로그인을 다시 호출합니다. | |
| PROVIDER_ | 기관 통신 오류 — 기관이 오류로 답하거나 연결이 끊겨 PDF 요청이 처리됐는지 알 수 없을 수 있으니, 다시 요청하기 전에 증명서 신청이력 목록 조회로 그 신청의 처리 상태와 출력 가능 여부를 먼저 확인합니다. 기관이 오류 응답을 보내거나 응답이 오지 않거나 연결이 끊긴 경우 error.message 는 결과 확인 불가 안내('기관의 요청 처리 여부를 확인하지 못했습니다. 다시 실행하지 마세요. 이미 처리됐을 수 있어 중복 처리로 이어집니다.')입니다. | |
| PROVIDER_ | 검증 오류 — 보낸 값이 빠졌거나 형식이 맞지 않거나 값에 맞는 대상을 찾지 못한 경우입니다. error.message 가 알려 주는 값을 고쳐 다시 호출합니다. | |
| PROVIDER_ | 출력할 건 없음 — 출력할 수 있는 증명서가 없습니다. 증명서 신청 이력에서 처리상태가 출력가능인 건을 골라 주세요. |
8. 증명서 발급사실 확인fourinsure. b1. certificate. issue_ fact. confirm
MCP 도구 이름 fourinsure__
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
발급번호로 증명서가 발급된 사실이 있는지와 발급일자, 발급처, 기관 안내 문구를 돌려줍니다.
Request
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. | |
| X- | Y | 호출 환경입니다.
| |
| Idempotency- | Y | 재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. | |
| Content- | Y | 요청 본문 형식입니다.
| |
| X- | N | 추적 아이디입니다. 지정하지 않으면 서버가 발급합니다. |
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| provider | string | - | Y | 호출할 기관입니다.
| |
| action | string | - | Y | 호출할 작업입니다.
| |
| account_ | string | 36 | 조건부 | 등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | Y | 작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
| 순번 | 변수명 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
| join_ | string | Y | 증명서 종류 joinKindCd. 0/2/3=사업장(bpmno 필수), 1=가입자(idnty_nm·frnt_rrno 필수) | |
| issu_ | string | Y | 발급번호 issuNo (숫자만 추출) | |
| bpmno | string | N | 사업장관리번호 11자리. join_kind_cd 0/2/3 시 필수 | |
| idnty_ | string | N | 가입자 성명. join_kind_cd 1 시 필수 | |
| frnt_ | string | N | 주민번호 앞 6자리. join_kind_cd 1 시 필수 |
- 「<필수>」 자리는 예시 값이 없는 필수 칸입니다. 위 파라미터 표를 보고 실제 값으로 바꿔 보냅니다.
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 에 담깁니다.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| success | boolean | 요청 처리 성공 여부 | |
| verified | boolean | 발급사실 검증 결과 | |
| status_ | string | 상태 코드 | |
| requested_ | string | 요청 가입종류 코드 | |
| submitted_ | string | 제출 가입종류 코드 | |
| input_ | string | 입력 모드 | |
| document_ | string | 문서 유형 | |
| title | string | 화면/결과 제목 | |
| message | string | 결과 메시지 | |
| issu_ | string | 발급번호 | |
| bpmno | string | null | 사업장관리번호 | |
| issued_ | string | 발급일 | |
| issued_ | string | 발급일 표시 텍스트 | |
| issuer | string | 발급 기관 | |
| submitted_ | object | 제출 payload 맵 | |
| csrf_ | boolean | CSRF 토큰 존재 여부 | |
| raw_ | number | 원본 HTML 길이 | |
| source_ | string | 서버가 요청한 기관 화면 주소 |
// 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_ | 세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다. | |
| PROVIDER_ | 인증 만료 — 인증이 만료됐습니다. 로그인을 다시 호출합니다. | |
| PROVIDER_ | 업스트림 오류 — 기관 연결 실패, 응답 없음, 오류 응답, 읽을 수 없는 응답입니다. error.message 안내대로 잠시 후 다시 호출하거나 보낸 값과 연동 계정 권한을 확인합니다. | |
| VALIDATION_ | 필수 칸 누락 — 필수 칸(join_kind_cd, issu_no)이 비어 있어 기관을 부르기 전에 거절했습니다. error.message 가 빠진 칸 이름을 알려 줍니다. 재시도 불가로 표시되니 그 칸을 채워 다시 호출합니다. | |
| PROVIDER_ | 검증 오류 — 보낸 값이 빠졌거나 형식이 맞지 않거나 값에 맞는 대상을 찾지 못한 경우입니다. error.message 가 알려 주는 값을 고쳐 다시 호출합니다. |