사업자등록 - 공공데이터 기업 위험 조회
이 쪽의 모든 작업에 해당
- 이 API 는 기관 연동과 기관 로그인이 필요 없습니다. 기관 자격증명을 등록하지 않아도 호출할 수 있고, account_link_id 는 보내지 않습니다.
1. 국세청 사업자등록 상태 조회opendata. nts. status
MCP 도구 이름 opendata__
POSThttps:// api. xdata. kr/ v1/ jobsX-Env-Scope: real_test
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
사업자등록번호로 휴업과 폐업 여부, 과세유형을 국세청 자료에서 조회합니다.
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 | 호출할 작업입니다.
| |
| params | object | Y | 작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다. | |
| encrypted_ | object | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
| 순번 | 변수명 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
| b_ | array | Y | 사업자등록번호 목록 - 각 10자리 숫자(예: ["1248100998"]). 최대 100건 | |
| output_ | array | N | 이 결과를 엑셀(xlsx) 파일로도 받으려면 적습니다. 예: ["xlsx"]. 파일은 result.artifacts 에 함께 오고, 빼면 데이터만 옵니다 |
- 「<필수>」 자리는 예시 값이 없는 필수 칸입니다. 위 파라미터 표를 보고 실제 값으로 바꿔 보냅니다.
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: status-$(date +%s)-$RANDOM" \
--header 'Content-Type: application/json' \
--data '{
"provider": "opendata",
"action": "opendata.nts.status",
"params": {
"b_no": "<필수: array>"
}
}'Response
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| source_ | string | 이 작업의 원천 데이터셋 번호입니다. 이 작업에서는 항상 15081808 입니다(공공데이터포털 data.go.kr 의 번호). | |
| action | string | 호출한 작업 이름입니다. 이 작업에서는 항상 opendata.nts.status 입니다. | |
| job_ | string | 이 결과를 만든 작업의 ID 입니다. | |
| source | object | 원천의 출처 정보입니다. 결과를 사용자에게 보여 줄 때 출처 표시에 씁니다. | |
| source. | string | 원천 데이터셋 번호입니다. source_id 와 같은 값입니다. | |
| source. | string | 원천 데이터를 제공하는 기관 이름입니다. 이 작업에서는 항상 국세청 입니다. | |
| source. | string | 원천 데이터의 이용 허락 범위 표기입니다. 값은 원천마다 다르고, 결과를 보여 줄 때 출처 표시와 함께 씁니다. | |
| license_ | array | 출처 표시 문구, 이용 허락 표기, 결과 해석 안내가 이 순서로 담긴 문장 목록입니다. 첫 줄은 「출처: 국세청 사업자등록 상태 / data.go.kr 15081808」 입니다. | |
| upstream | object | 국세청 사업자등록정보 진위확인 및 상태조회 서비스의 응답을 담습니다. 응답의 칸은 바꾸지 않고, data 의 행마다 crno, corp_name_norm 칸만 더합니다. 아래 칸은 그 서비스 명세가 정한 응답 칸과 더한 칸이고, 국세청이 칸을 더하면 그 칸도 그대로 옵니다. | |
| upstream. | string | 국세청 서비스가 알려 주는 처리 결과 코드입니다. OK 가 아닌 코드가 오면 작업이 실패로 끝나므로, 성공한 결과에서는 OK 입니다. | |
| upstream. | number | 국세청에 등록되어 상태가 조회된 사업자등록번호의 수입니다. 조회된 번호가 하나도 없으면 이 칸이 오지 않을 수 있습니다. | |
| upstream. | number | 조회를 요청한 사업자등록번호의 수입니다. | |
| upstream. | array | 요청한 사업자등록번호마다 한 행씩 담긴 목록입니다. | |
| upstream. | string | 사업자등록번호입니다(숫자 10자리). | |
| upstream. | string | 사업자등록 상태의 이름입니다. 「계속사업자」, 「휴업자」, 「폐업자」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다. | |
| upstream. | string | 사업자등록 상태의 코드입니다. 01 「계속사업자」, 02 「휴업자」, 03 「폐업자」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다. | |
| upstream. | string | 과세유형의 이름입니다. 「부가가치세 일반과세자」, 「부가가치세 간이과세자」, 「부가가치세 과세특례자」, 「부가가치세 면세사업자」, 「수익사업을 영위하지 않는 비영리법인이거나 고유번호가 부여된 단체,국가기관 등」, 「고유번호가 부여된 단체」, 「부가가치세 간이과세자(세금계산서 발급사업자)」 가운데 하나입니다. 국세청에 등록되지 않았거나 삭제된 번호이면 「국세청에 등록되지 않은 사업자등록번호입니다」 와 같은 뜻의 안내 문장이 옵니다. | |
| upstream. | string | 과세유형의 코드입니다. 01 「부가가치세 일반과세자」, 02 「부가가치세 간이과세자」, 03 「부가가치세 과세특례자」, 04 「부가가치세 면세사업자」, 05 「수익사업을 영위하지 않는 비영리법인이거나 고유번호가 부여된 단체,국가기관 등」, 06 「고유번호가 부여된 단체」, 07 「부가가치세 간이과세자(세금계산서 발급사업자)」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다. | |
| upstream. | string | 폐업일자입니다(YYYYMMDD). 값이 없으면 빈 문자열입니다. | |
| upstream. | string | 단위과세 전환으로 폐업했는지를 나타내는 값입니다(Y 또는 N). 국세청에 등록되지 않은 번호이면 빈 문자열입니다. | |
| upstream. | string | 가장 최근에 과세유형이 바뀐 날짜입니다(YYYYMMDD). 값이 없으면 빈 문자열입니다. | |
| upstream. | string | 세금계산서 적용일자입니다(YYYYMMDD). 값이 없으면 빈 문자열입니다. | |
| upstream. | string | 직전 과세유형의 이름입니다. 「부가가치세 일반과세자」, 「부가가치세 간이과세자」, 「부가가치세 간이과세자(세금계산서 발급사업자)」, 「해당없음」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다. | |
| upstream. | string | 직전 과세유형의 코드입니다. 01 「부가가치세 일반과세자」, 02 「부가가치세 간이과세자」, 07 「부가가치세 간이과세자(세금계산서 발급사업자)」, 99 「해당없음」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다. | |
| upstream. | string | null | 법인등록번호입니다. 국세청 응답에 없는 칸으로, 다른 조회를 하며 모아 둔 식별자 색인에서 이 행의 사업자등록번호로 찾아 붙입니다. 색인에 그 번호가 없거나, 색인의 그 기록이 유효 기한을 넘겼거나, 색인을 읽지 못했으면 null 이고 상태 조회 결과는 그대로 옵니다. | |
| upstream. | string | null | 법인명입니다. 국세청 응답에 없는 칸으로, 다른 조회를 하며 모아 둔 식별자 색인에서 이 행의 사업자등록번호로 찾아 붙입니다. 색인에 그 번호가 없거나, 색인의 그 기록이 유효 기한을 넘겼거나, 색인을 읽지 못했으면 null 이고 상태 조회 결과는 그대로 옵니다. |
// result.data - 값 자리에는 각 칸의 형식을 적었습니다 (실제 값이 아닙니다)
{
"source_id": "<string>",
"action": "<string>",
"job_id": "<string>",
"source": {
"id": "<string>",
"org": "<string>",
"license": "<string>"
},
"license_notes": [],
"upstream": {
"status_code": "<string>",
"match_cnt": "<number>",
"request_cnt": "<number>",
"data": [
{
"b_no": "<string>",
"b_stt": "<string>",
"b_stt_cd": "<string>",
"tax_type": "<string>",
"tax_type_cd": "<string>",
"end_dt": "<string>",
"utcc_yn": "<string>",
"tax_type_change_dt": "<string>",
"invoice_apply_dt": "<string>",
"rbf_tax_type": "<string>",
"rbf_tax_type_cd": "<string>",
"crno": "<string | null>",
"corp_name_norm": "<string | null>"
}
]
}
}| 순번 | 오류 코드 | 발생 조건 |
|---|---|---|
| POLICY_ | 공공데이터 조회의 하루 한도를 모두 쓰면 작업이 이 오류로 끝납니다. error.message 는 「오늘 이 조직의 공공데이터 조회 한도를 모두 썼습니다. 한국시간 자정에 다시 열립니다. 한도 상향이 필요하면 서비스문의로 알려 주세요.」 꼴이고, 한도의 범위에 따라 「이 조직의」 대신 「무료 요금제 몫의」 나 「서비스 전체」 가 들어갑니다. 자정이 지난 뒤에 다시 요청합니다. | |
| PROVIDER_ | 공공데이터 제공처가 오류로 답하면 작업이 이 오류로 끝나고, error.message 는 응답 상태로 고릅니다. 429 이면 「요청이 잠시 제한되었습니다. 잠시 후 다시 시도해 주세요.」, 500번대이면 「일시적인 오류로 요청을 마치지 못했습니다. 잠시 후 다시 시도해 주세요.」, 401 과 403 을 뺀 400번대이면 「요청을 처리할 수 없습니다. 입력한 값을 다시 확인해 주세요.」 입니다(401 과 403, 그리고 제공처가 인증키나 접근 권한을 거절한 응답은 이 오류가 아니라 INTERNAL_ERROR 로 끝납니다). 응답은 받았는데 읽지 못했거나 상태를 알 수 없으면 「기관에서 받은 응답을 처리하지 못했습니다. 잠시 후 다시 시도해 주시고, 계속되면 서비스문의로 알려 주세요.」 가 오고, 상태가 400번대도 500번대도 아니면 「일시적인 오류로 요청을 마치지 못했습니다. 잠시 후 다시 시도해 주세요.」 가 옵니다. | |
| VALIDATION_ | 요청 값이 맞지 않으면 작업이 이 오류로 끝나고, 요청을 고쳐 다시 요청합니다. 값이 빠지면 error.message 는 「요청에 필요한 값이 빠졌습니다. 빠진 값: 칸 이름. 그 값을 넣어 다시 요청해 주세요.」 꼴이고, 값의 형식이 틀리면 「요청 값이 올바르지 않습니다. 확인할 값: 칸 이름. 값을 고쳐 다시 요청해 주세요.」 꼴입니다(칸 이름이 다섯을 넘으면 앞 다섯과 「외 N개」 를 적습니다). 지원하지 않는 작업을 부르면 「지원하지 않는 작업입니다.」 입니다. | |
| INTERNAL_ | XBOSS 쪽 설정이나 처리 결함으로 끝나면 이 오류가 나가고 error.message 는 「서버 내부 오류로 작업을 마치지 못했습니다. 서비스문의로 알려 주세요.」 입니다. 고객이 고칠 값이 없으므로 잠시 뒤 다시 요청하고, 계속되면 서비스문의로 알려 주세요. 공공데이터 제공처가 XBOSS 의 이용 권한을 받아들이지 않을 때(응답 상태 401 이나 403, 또는 인증키나 접근 권한을 거절한 응답)도 이 오류이고 error.message 는 「조회 서비스를 이용할 수 없습니다. 서비스문의로 연결 상태 확인을 요청해 주세요.」 입니다. 다시 요청해도 같은 결과이므로 서비스문의로 알려 주세요. |
2. 국세청 사업자등록 진위 확인opendata. nts. validate
MCP 도구 이름 opendata__
POSThttps:// api. xdata. kr/ v1/ jobsX-Env-Scope: real_test
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
사업자등록번호와 개업일자, 대표자명이 국세청 자료와 맞는지 대조합니다.
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 | 호출할 작업입니다.
| |
| params | object | Y | 작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다. | |
| encrypted_ | object | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
- 대괄호 []는 목록의 각 항목을, 점은 객체의 속성을, {key}는 실제 키로 바꿔 넣는 사전 항목을 뜻하며, 선택인 부모를 보낼 때 하위 필수 칸은 조건부로 표시합니다.
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| businesses | array | - | Y | 진위 확인 대상 사업자 목록. 항목마다 b_no, start_dt(YYYYMMDD), p_nm 이 필수. 최대 100개 | |
| businesses[]. | string | - | Y | 사업자등록번호(10자리 숫자) | |
| businesses[]. | string | 8 | Y | 개업일자 | |
| businesses[]. | string | - | Y | 대표자 성명 | |
| businesses[]. | string | - | N | 대표자 한글명(선택). 대표자성명(p_nm)이 외국인 영문명일 때만 그 한글명을 넣습니다. 공동대표자명이 아니며, 내국인은 비웁니다 | |
| businesses[]. | string | - | N | 상호 | |
| businesses[]. | string | - | N | 법인등록번호 | |
| businesses[]. | string | - | N | 업태 | |
| businesses[]. | string | - | N | 종목 |
- 「<필수>」 자리는 예시 값이 없는 필수 칸입니다. 위 파라미터 표를 보고 실제 값으로 바꿔 보냅니다.
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: validate-$(date +%s)-$RANDOM" \
--header 'Content-Type: application/json' \
--data '{
"provider": "opendata",
"action": "opendata.nts.validate",
"params": {
"businesses": [
{
"b_no": "<필수>",
"start_dt": "<필수>",
"p_nm": "<필수>"
}
]
}
}'Response
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| source_ | string | 이 작업의 원천 데이터셋 번호입니다. 이 작업에서는 항상 15081808 입니다(공공데이터포털 data.go.kr 의 번호). | |
| action | string | 호출한 작업 이름입니다. 이 작업에서는 항상 opendata.nts.validate 입니다. | |
| job_ | string | 이 결과를 만든 작업의 ID 입니다. | |
| source | object | 원천의 출처 정보입니다. 결과를 사용자에게 보여 줄 때 출처 표시에 씁니다. | |
| source. | string | 원천 데이터셋 번호입니다. source_id 와 같은 값입니다. | |
| source. | string | 원천 데이터를 제공하는 기관 이름입니다. 이 작업에서는 항상 국세청 입니다. | |
| source. | string | 원천 데이터의 이용 허락 범위 표기입니다. 값은 원천마다 다르고, 결과를 보여 줄 때 출처 표시와 함께 씁니다. | |
| license_ | array | 출처 표시 문구, 이용 허락 표기, 결과 해석 안내가 이 순서로 담긴 문장 목록입니다. 첫 줄은 「출처: 국세청 사업자등록 진위 / data.go.kr 15081808」 입니다. | |
| upstream | object | 국세청 사업자등록정보 진위확인 및 상태조회 서비스의 응답을 가공하지 않고 그대로 담습니다. 아래 칸은 그 서비스 명세가 정한 응답 칸이고, 국세청이 칸을 더하면 그 칸도 그대로 옵니다. | |
| upstream. | string | 국세청 서비스가 알려 주는 처리 결과 코드입니다. OK 가 아닌 코드가 오면 작업이 실패로 끝나므로, 성공한 결과에서는 OK 입니다. | |
| upstream. | number | 진위 확인을 요청한 사업자 정보의 수입니다. | |
| upstream. | number | 요청한 사업자 정보 가운데 국세청 자료와 일치한 건수입니다. 일치한 건이 하나도 없으면 이 칸이 오지 않을 수 있습니다. | |
| upstream. | array | 요청한 사업자 정보마다 한 행씩 담긴 목록입니다. | |
| upstream. | string | 요청한 사업자등록번호입니다. | |
| upstream. | string | 진위 확인 결과 코드입니다. 01 이면 국세청 자료와 일치하고 02 이면 일치하지 않습니다. | |
| upstream. | string | 일치하지 않을 때(valid 가 02) 오는 안내 문장으로, 국세청 자료에서 확인할 수 없다는 뜻입니다. 일치할 때는 이 칸이 오지 않습니다. | |
| upstream. | object | 요청에 담아 보낸 사업자 정보 한 건입니다. 요청의 params.businesses[] 한 항목과 같은 칸입니다. | |
| upstream. | object | 일치한 사업자의 국세청 상태입니다. 안쪽 칸은 사업자 상태조회(opendata.nts.status)의 upstream.data[] 행과 같습니다. 일치하지 않으면 이 칸이 오지 않을 수 있습니다. | |
| upstream. | string | 사업자등록번호입니다(숫자 10자리). | |
| upstream. | string | 사업자등록 상태의 이름입니다. 「계속사업자」, 「휴업자」, 「폐업자」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다. | |
| upstream. | string | 사업자등록 상태의 코드입니다. 01 「계속사업자」, 02 「휴업자」, 03 「폐업자」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다. | |
| upstream. | string | 과세유형의 이름입니다. 「부가가치세 일반과세자」, 「부가가치세 간이과세자」, 「부가가치세 과세특례자」, 「부가가치세 면세사업자」, 「수익사업을 영위하지 않는 비영리법인이거나 고유번호가 부여된 단체,국가기관 등」, 「고유번호가 부여된 단체」, 「부가가치세 간이과세자(세금계산서 발급사업자)」 가운데 하나입니다. 국세청에 등록되지 않았거나 삭제된 번호이면 「국세청에 등록되지 않은 사업자등록번호입니다」 와 같은 뜻의 안내 문장이 옵니다. | |
| upstream. | string | 과세유형의 코드입니다. 01 「부가가치세 일반과세자」, 02 「부가가치세 간이과세자」, 03 「부가가치세 과세특례자」, 04 「부가가치세 면세사업자」, 05 「수익사업을 영위하지 않는 비영리법인이거나 고유번호가 부여된 단체,국가기관 등」, 06 「고유번호가 부여된 단체」, 07 「부가가치세 간이과세자(세금계산서 발급사업자)」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다. | |
| upstream. | string | 폐업일자입니다(YYYYMMDD). 값이 없으면 빈 문자열입니다. | |
| upstream. | string | 단위과세 전환으로 폐업했는지를 나타내는 값입니다(Y 또는 N). 국세청에 등록되지 않은 번호이면 빈 문자열입니다. | |
| upstream. | string | 가장 최근에 과세유형이 바뀐 날짜입니다(YYYYMMDD). 값이 없으면 빈 문자열입니다. | |
| upstream. | string | 세금계산서 적용일자입니다(YYYYMMDD). 값이 없으면 빈 문자열입니다. | |
| upstream. | string | 직전 과세유형의 이름입니다. 「부가가치세 일반과세자」, 「부가가치세 간이과세자」, 「부가가치세 간이과세자(세금계산서 발급사업자)」, 「해당없음」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다. | |
| upstream. | string | 직전 과세유형의 코드입니다. 01 「부가가치세 일반과세자」, 02 「부가가치세 간이과세자」, 07 「부가가치세 간이과세자(세금계산서 발급사업자)」, 99 「해당없음」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다. |
// result.data - 값 자리에는 각 칸의 형식을 적었습니다 (실제 값이 아닙니다)
{
"source_id": "<string>",
"action": "<string>",
"job_id": "<string>",
"source": {
"id": "<string>",
"org": "<string>",
"license": "<string>"
},
"license_notes": [],
"upstream": {
"status_code": "<string>",
"request_cnt": "<number>",
"valid_cnt": "<number>",
"data": [
{
"b_no": "<string>",
"valid": "<string>",
"valid_msg": "<string>",
"request_param": {},
"status": {
"b_no": "<string>",
"b_stt": "<string>",
"b_stt_cd": "<string>",
"tax_type": "<string>",
"tax_type_cd": "<string>",
"end_dt": "<string>",
"utcc_yn": "<string>",
"tax_type_change_dt": "<string>",
"invoice_apply_dt": "<string>",
"rbf_tax_type": "<string>",
"rbf_tax_type_cd": "<string>"
}
}
]
}
}| 순번 | 오류 코드 | 발생 조건 |
|---|---|---|
| POLICY_ | 공공데이터 조회의 하루 한도를 모두 쓰면 작업이 이 오류로 끝납니다. error.message 는 「오늘 이 조직의 공공데이터 조회 한도를 모두 썼습니다. 한국시간 자정에 다시 열립니다. 한도 상향이 필요하면 서비스문의로 알려 주세요.」 꼴이고, 한도의 범위에 따라 「이 조직의」 대신 「무료 요금제 몫의」 나 「서비스 전체」 가 들어갑니다. 자정이 지난 뒤에 다시 요청합니다. | |
| PROVIDER_ | 공공데이터 제공처가 오류로 답하면 작업이 이 오류로 끝나고, error.message 는 응답 상태로 고릅니다. 429 이면 「요청이 잠시 제한되었습니다. 잠시 후 다시 시도해 주세요.」, 500번대이면 「일시적인 오류로 요청을 마치지 못했습니다. 잠시 후 다시 시도해 주세요.」, 401 과 403 을 뺀 400번대이면 「요청을 처리할 수 없습니다. 입력한 값을 다시 확인해 주세요.」 입니다(401 과 403, 그리고 제공처가 인증키나 접근 권한을 거절한 응답은 이 오류가 아니라 INTERNAL_ERROR 로 끝납니다). 응답은 받았는데 읽지 못했거나 상태를 알 수 없으면 「기관에서 받은 응답을 처리하지 못했습니다. 잠시 후 다시 시도해 주시고, 계속되면 서비스문의로 알려 주세요.」 가 오고, 상태가 400번대도 500번대도 아니면 「일시적인 오류로 요청을 마치지 못했습니다. 잠시 후 다시 시도해 주세요.」 가 옵니다. | |
| VALIDATION_ | 요청 값이 맞지 않으면 작업이 이 오류로 끝나고, 요청을 고쳐 다시 요청합니다. 값이 빠지면 error.message 는 「요청에 필요한 값이 빠졌습니다. 빠진 값: 칸 이름. 그 값을 넣어 다시 요청해 주세요.」 꼴이고, 값의 형식이 틀리면 「요청 값이 올바르지 않습니다. 확인할 값: 칸 이름. 값을 고쳐 다시 요청해 주세요.」 꼴입니다(칸 이름이 다섯을 넘으면 앞 다섯과 「외 N개」 를 적습니다). 지원하지 않는 작업을 부르면 「지원하지 않는 작업입니다.」 입니다. | |
| INTERNAL_ | XBOSS 쪽 설정이나 처리 결함으로 끝나면 이 오류가 나가고 error.message 는 「서버 내부 오류로 작업을 마치지 못했습니다. 서비스문의로 알려 주세요.」 입니다. 고객이 고칠 값이 없으므로 잠시 뒤 다시 요청하고, 계속되면 서비스문의로 알려 주세요. 공공데이터 제공처가 XBOSS 의 이용 권한을 받아들이지 않을 때(응답 상태 401 이나 403, 또는 인증키나 접근 권한을 거절한 응답)도 이 오류이고 error.message 는 「조회 서비스를 이용할 수 없습니다. 서비스문의로 연결 상태 확인을 요청해 주세요.」 입니다. 다시 요청해도 같은 결과이므로 서비스문의로 알려 주세요. |