어떤 정보를 확인하고 싶으세요?
먼저 법령 API를 연결하고, 다른 API는 필요한 업무에 맞게 선택하세요.
공식 자료를 반복해서 조회할 때
API는 K-wiki가 공식 자료를 조회하는 연결 통로입니다. 필요한 서비스에 신청하고, 내 PC의 인증 설정을 연결한 뒤 대표 조회로 확인합니다. 기존 위키 문서는 등록 전에도 읽을 수 있습니다.
공식 공개 화면·K-wiki 설정 자료 확인일 2026. 10. 5.
등록한 API를 어디에 쓰나요?
검색 조건·조회 상태·업무 적용의 차이를 먼저 이해하고, 각 API의 등록 안내 끝에서 업무별 따라하기로 이어가세요.
국가법령정보 공동활용에서 신청하세요
국가법령정보센터의 법령을 API로 사용하려면 공동활용 사이트에서 신청합니다.
- 처음 이용한다면 회원가입 화면에서 본인확인과 가입 절차를 진행하세요. 기존 회원은 로그인 후 OPEN API 신청으로 이동하세요.
- 신청 화면의 API인증키(OC)와 시스템 정보, 활용 목적, 필요한 법령 종류를 입력·선택하세요.
- 이용조건을 확인하고 신청한 뒤, 내 계정의 신청 상태를 확인하세요. 현재 공개 신청 화면은 자동승인으로 안내합니다.
| 항목 | 입력할 내용 |
|---|---|
| API인증키(OC) | API 호출에 사용할 인증값을 직접 지정합니다. |
| 시스템·홈페이지 정보 | 실제 사용하는 시스템명, 주요 기능, 도메인·IP 등 화면에서 요구하는 정보를 입력합니다. |
| 활용 목적 | 업무에서 법령을 어떻게 사용할지 구체적으로 적습니다. |
| 공동활용 법령종류 | 법령·행정규칙 등 실제 조회할 자료를 선택합니다. |
한국원자력의학원 업무 검토를 위해 관련 법령과 행정규칙을 검색하고, 시행일과 원문을 확인하여 내부규정과 대조하는 데 활용합니다.
실제 사용 목적에 맞게 고쳐 쓰세요. 도메인·IP 등 입력값이 불확실하면 공식 이용문의로 확인하세요.신청 항목·승인 방식 근거: 공식 신청 화면 (새 창)
마이페이지에서 OC를 확인하세요
OC는 K-wiki가 API를 호출할 때 사용하는 인증값입니다.
- 공동활용 사이트에 로그인하세요.
- 마이페이지 → API인증키관리에서 현재 API인증키(OC)를 확인하세요.
- 확인한 값을 내 PC의 K-wiki 설정에 입력할 준비를 하세요. 이메일 아이디와 같다고 추정하지 말고, 관리 화면의 현재 값을 기준으로 합니다.
이 교육 페이지에 OC를 입력할 필요는 없습니다. 실제 값은 공유 문서·화면 캡처·대화·로그에 남기지 마세요. OC를 변경했다면 기존 도구의 로컬 설정도 다시 확인해야 합니다.
내 K-wiki 폴더에 연결하세요
설치한 AI 도구에서 K-wiki를 열고, 아래 요청으로 설정을 준비하세요.
.envLAW_API_OC아래 요청을 보내 설정 파일을 준비한 뒤, OC는 로컬 파일에 직접 입력하세요. 이미 다른 설정이 있다면 그대로 보존합니다. 이 교육 사이트 폴더의 설정과 혼동하지 마세요.
AI에게 설정 준비 요청하기
K-wiki의 AGENTS.md와 03_skills/17_api_mcp_setup/SKILL.md, 03_skills/17_api_mcp_setup/references/local_config_and_verification.md를 먼저 읽어줘. 국가법령정보 공동활용에서 확인한 OC를 K-wiki 루트 .env의 LAW_API_OC에 직접 입력할 수 있도록 기존 설정을 보존하면서 로컬 설정 파일을 준비해줘. 실제 OC 값은 내가 로컬 파일에 입력할게. 05_tools/law_api/law_api_client.py가 실행될 때 LAW_API_OC를 전달받는지도 확인해줘. 키 값과 .env 내용은 대화나 로그에 출력하지 말고, 다른 위키 문서는 수정하지 마.
직접 입력할 때의 파일 형식
K-wiki 루트 .env에서 아래 변수의 값만 실제 OC로 바꾸세요. 아래는 예시이며 인증값이 아닙니다.
LAW_API_OC=YOUR_OC루트 .env.example의 변수명을 기준으로 입력합니다. 실제 값이 든 .env는 공유본과 Git에 포함하지 않습니다.
현재 확인한 K-wiki 법령 클라이언트는 루트 .env를 읽습니다. 실행 프로세스에 같은 이름의 LAW_API_OC 환경변수가 있다면 그 값이 우선합니다. 파일 저장과 조회 성공을 구분해 확인하세요.
K-wiki 설정 기준: 03_skills/17_api_mcp_setup/SKILL.md
실제 조회 도구: 05_tools/law_api/law_api_client.py
검색 1건으로 연결을 확인하세요
설정 파일이 있는 것과 실제 조회에 성공하는 것은 다릅니다.
AI에게 연결 확인 요청하기
K-wiki의 03_skills/10_law_api/SKILL.md를 확인한 뒤, 국가법령정보 API로 근로기준법을 1건 검색해줘. 기존 로컬 LAW_API_OC 설정을 실행 환경에 전달해 사용하고, 실제 값은 출력하지 마. 조회 성공 여부와 결과 건수, 법령명, 법령 식별정보, 시행일을 알려줘. 실패하면 설정 없음·인증/승인·연결·검색조건 문제를 구분해 설명해줘. 원문 파일 저장과 위키 반영은 하지 마.
- 조회 성공 여부와 결과 건수
- 검색한 법령의 이름과 식별정보
- 반환된 시행일
- 실패 시 오류 유형과 다음 확인사항
터미널에서 확인하고 싶다면
Python이 설치되어 있고, 현재 실행 환경에 LAW_API_OC가 전달된 상태에서 K-wiki 폴더를 기준으로 실행하세요. 키를 명령 인자에 넣지 않습니다.
python 05_tools/law_api/law_api_client.py search "근로기준법" --display 1검색 결과가 0건이면 검색어와 제공 범위를 확인하세요. 오류가 난 경우에는 인증·승인·연결 상태를 확인합니다. 교육 예시의 법령 검색은 실제 업무 결론을 의미하지 않습니다.
심평원 · HIRA API
병원 기본정보와 의료기관 상세정보, 약가기준, 비급여 진료비, 평가정보 등 공개 항목을 조회합니다.
01 · 공식 사이트에서 신청하기
- 공공데이터포털에 로그인하고 아래에서 필요한 심평원 서비스를 선택해 활용신청하세요. 처음에는 병원정보서비스부터 확인합니다.
- 활용신청 현황에서 서비스별 승인 상태를 확인하세요. 병원정보서비스는 현재 개발단계 자동승인, 운영단계 심의승인으로 안내됩니다. 다른 서비스는 각 상세 화면의 심의유형을 확인합니다.
- 공공데이터포털 공통키를 처음 연결한다면 K-wiki 루트 .env의 DATA_GO_KR_API_KEY에 한 번만 입력하세요. 이미 등록했다면 같은 키로 병원정보를 조회합니다. 기관명과 소재지로 기관을 구분하고, 상세·비급여·평가 조회에는 반환된 요양기호를 사용합니다.
심평원 · HIRA의 세부 서비스 신청처 (7개)
실제 필요한 서비스를 골라 신청하세요. 같은 키를 사용해도 서비스별 승인은 확인해야 합니다.
| 서비스 | 활용할 자료 |
|---|---|
| 병원정보 ↗ (새 창) | 병원명·소재지·요양기호 |
| 약가기준정보 ↗ (새 창) | 의약품 마스터·급여구분·상한가 |
| 특수진료병원정보 ↗ (새 창) | 특수진료 가능 기관 후보 |
| 의료기관별 상세정보 ↗ (새 창) | 진료과목·시설 등 공개 정보 |
| 비급여 진료비 ↗ (새 창) | 공개 비급여 항목과 금액 |
| 병원평가정보 ↗ (새 창) | 공개 평가항목·등급 |
| 우수기관 병원평가정보 ↗ (새 창) | 우수기관 공개 평가정보 |
02 · 내 K-wiki에 연결하기
.envDATA_GO_KR_API_KEY심평원·나라장터·국세청은 공공데이터포털 키 하나를 함께 사용합니다. 이미 등록했다면 다시 입력할 필요 없이 이 서비스의 활용신청·승인을 확인하세요. 공통키 한 번 등록하기 →
심평원 · HIRA 설정 준비 요청문
아직 공통키를 등록하지 않았다면 아래 요청으로 한 번만 준비하세요. 세 서비스의 설정 요청문은 같습니다.
K-wiki의 AGENTS.md와 03_skills/17_api_mcp_setup/SKILL.md, 03_skills/17_api_mcp_setup/references/local_config_and_verification.md, 05_tools/hira_api/README.md, 05_tools/g2b_api/README.md, 05_tools/nts_api/README.md를 먼저 읽어줘. 공공데이터포털 인증키 하나를 심평원·나라장터·국세청에서 공통으로 사용할 거야. 루트 .env의 DATA_GO_KR_API_KEY에 한 번만 직접 입력할 수 있도록 설정 파일을 준비해줘. 이미 공통키가 등록되어 있으면 그대로 사용하고, 서비스별 인증키 설정은 추가하지 마. 세 도구가 공통키를 사용하는지 확인하고, 기존 설정과 충돌하면 값 없이 설정 이름과 조치만 알려줘. 기존 설정을 임의로 삭제하거나 덮어쓰지 마. 실제 키는 내가 로컬 파일에 입력할게. 활용신청과 승인은 필요한 서비스마다 따로 확인하도록 안내해줘. 실제 키와 .env 내용은 대화·로그·출력에 표시하지 말고, 다른 위키 문서는 수정하지 마.
03 · 대표 조회로 확인하기
심평원 · HIRA 조회 요청
K-wiki의 05_tools/hira_api/README.md를 먼저 확인해줘. 심평원 병원정보 API로 한국원자력의학원을 조회해줘. 기관명·소재지·요양기호, 사용한 서비스, 조회 시점과 조회 성공 여부를 알려줘. 루트 .env에 한 번 등록한 DATA_GO_KR_API_KEY 공통키를 사용하고, 이 서비스의 활용승인도 확인해줘. 서비스별 인증키 설정은 추가하지 마. 실제 인증키는 출력하지 마. 성공·정상 무결과·부분 수집·실패를 구분하고, 원문 저장과 위키 반영은 하지 마.
- 기관명이 같아도 소재지와 요양기호가 맞는지 확인
- 실제로 승인받은 서비스명과 조회 시점 확인
- 빈 값·누락값을 0이나 해당 없음으로 단정하지 않기
같은 인증키를 사용해도 상세정보·비급여·평가정보 등 필요한 서비스는 각각 활용신청과 승인 상태를 확인하세요. 공개 데이터는 의료·급여 적용 판단의 단독 근거가 아니며 공식 고시와 적용일 등을 함께 확인합니다.
K-wiki 도구 안내: 05_tools/hira_api/README.md
공식 공개 안내·로컬 구현 확인일 2026. 10. 5. · 개인 계정 신청·인증 조회는 별도 확인
준비 자료·검색 조건·결과 예시·확인할 점을 함께 살펴봅니다.
심평원 기관정보 비교 →나라장터 · G2B API
입찰공고와 기초금액·변경이력을 찾고, 필요하면 낙찰·계약·사전규격·발주계획·계약과정 정보를 확인합니다.
01 · 공식 사이트에서 신청하기
- 공공데이터포털에서 조달청 나라장터 입찰공고정보서비스를 선택하고 활용신청하세요.
- 해당 서비스의 승인 상태를 확인하세요. 입찰공고정보서비스는 현재 개발·운영단계 자동승인으로 안내됩니다. 다른 서비스의 심의유형과 호출량은 각 상세 화면에서 확인합니다.
- 이미 등록한 DATA_GO_KR_API_KEY 공통키를 그대로 사용하세요. 처음이라면 K-wiki 루트 .env에 한 번만 등록합니다. 검색 기간·공고 종류·기관명을 좁혀 대표 조회를 요청하고, 낙찰·계약·사전규격 등이 필요하면 해당 서비스를 추가 신청합니다.
나라장터 · G2B의 세부 서비스 신청처 (6개)
실제 필요한 서비스를 골라 신청하세요. 같은 키를 사용해도 서비스별 승인은 확인해야 합니다.
| 서비스 | 활용할 자료 |
|---|---|
| 입찰공고정보 ↗ (새 창) | 공고·기초금액·변경이력 |
| 낙찰정보 ↗ (새 창) | 낙찰 결과 |
| 계약정보 ↗ (새 창) | 계약 메타정보 |
| 사전규격정보 ↗ (새 창) | 공개 사전규격 |
| 발주계획현황 ↗ (새 창) | 발주 예정 정보 |
| 계약과정통합공개 ↗ (새 창) | 계약 진행 과정 |
02 · 내 K-wiki에 연결하기
.envDATA_GO_KR_API_KEY심평원·나라장터·국세청은 공공데이터포털 키 하나를 함께 사용합니다. 이미 등록했다면 다시 입력할 필요 없이 이 서비스의 활용신청·승인을 확인하세요. 공통키 한 번 등록하기 →
나라장터 · G2B 설정 준비 요청문
아직 공통키를 등록하지 않았다면 아래 요청으로 한 번만 준비하세요. 세 서비스의 설정 요청문은 같습니다.
K-wiki의 AGENTS.md와 03_skills/17_api_mcp_setup/SKILL.md, 03_skills/17_api_mcp_setup/references/local_config_and_verification.md, 05_tools/hira_api/README.md, 05_tools/g2b_api/README.md, 05_tools/nts_api/README.md를 먼저 읽어줘. 공공데이터포털 인증키 하나를 심평원·나라장터·국세청에서 공통으로 사용할 거야. 루트 .env의 DATA_GO_KR_API_KEY에 한 번만 직접 입력할 수 있도록 설정 파일을 준비해줘. 이미 공통키가 등록되어 있으면 그대로 사용하고, 서비스별 인증키 설정은 추가하지 마. 세 도구가 공통키를 사용하는지 확인하고, 기존 설정과 충돌하면 값 없이 설정 이름과 조치만 알려줘. 기존 설정을 임의로 삭제하거나 덮어쓰지 마. 실제 키는 내가 로컬 파일에 입력할게. 활용신청과 승인은 필요한 서비스마다 따로 확인하도록 안내해줘. 실제 키와 .env 내용은 대화·로그·출력에 표시하지 말고, 다른 위키 문서는 수정하지 마.
03 · 대표 조회로 확인하기
나라장터 · G2B 조회 요청
K-wiki의 05_tools/g2b_api/README.md를 먼저 확인해줘. 나라장터에서 최근 7일간 한국원자력의학원의 물품 입찰공고를 최대 3건 조회해줘. 공고번호·공고명·게시일·원문 링크, 검색 기간과 조회 상태를 보여줘. 루트 .env에 한 번 등록한 DATA_GO_KR_API_KEY 공통키를 사용하고, 이 서비스의 활용승인도 확인해줘. 서비스별 인증키 설정은 추가하지 마. 실제 인증키는 출력하지 마. 성공·정상 무결과·부분 수집·실패를 구분하고, 원문 저장과 위키 반영은 하지 마.
- 검색 기간·물품/공사/용역 구분과 수요기관 확인
- 공고번호·원문 링크·조회 성공 여부 확인
- 일부 페이지 수집이나 중간 실패를 전체 목록과 구분
낙찰·계약·사전규격·발주계획·계약과정 조회가 거부되면 해당 서비스의 활용신청을 확인하세요. 정상 0건, 일부 수집, 인증 실패를 구분하고 필요에 맞게 기간과 검색조건을 조정합니다.
K-wiki 도구 안내: 05_tools/g2b_api/README.md
공식 공개 안내·로컬 구현 확인일 2026. 10. 5. · 개인 계정 신청·인증 조회는 별도 확인
준비 자료·검색 조건·결과 예시·확인할 점을 함께 살펴봅니다.
나라장터 공고 찾아보기 →ALIO · 알리오플러스 API
공공기관의 기관정보를 조회하고 비교할 기관을 찾습니다. 내부규정은 ALIO 공시 상세와 첨부 원문을 함께 확인합니다.
01 · 공식 사이트에서 신청하기
- 알리오플러스 Open API 안내에서 시설·행사·사업·기관정보 등 제공 항목을 확인하세요.
- 공식 안내의 인증키 발급 메뉴에서 필요한 로그인·신청을 진행하고 인증키 목록에서 발급 상태를 확인하세요.
- 발급받은 인증키를 K-wiki 루트 .env에 직접 입력하세요. 기관정보 도구 조회와 인증키가 필요한 Open API 호출을 구분해 확인합니다.
02 · 내 K-wiki에 연결하기
.envALIO_API_KEY이 서비스의 인증값을 사용하세요. 공공데이터포털 공통키로 대체하지 않습니다.
ALIO · 알리오플러스 설정 준비 요청문
아래 요청을 보낸 뒤 실제 인증키는 로컬 파일에 직접 입력하세요.
K-wiki의 AGENTS.md와 03_skills/17_api_mcp_setup/SKILL.md, 03_skills/17_api_mcp_setup/references/local_config_and_verification.md, 05_tools/alio_api/README.md를 먼저 읽어줘. ALIO · 알리오플러스 인증키를 루트 .env의 ALIO_API_KEY에 직접 입력할 수 있게 기존 설정을 보존하면서 로컬 설정 파일을 준비해줘. 실제 값은 내가 파일에 입력할게. 실제 키와 .env 내용은 대화·로그·출력에 표시하지 말고, 다른 위키 문서는 수정하지 마.
03 · 대표 조회로 확인하기
ALIO · 알리오플러스 조회 요청
K-wiki의 05_tools/alio_api/README.md를 먼저 확인해줘. ALIO 도구로 한국원자력의학원의 기관정보를 조회해줘. 기관 식별정보와 출처를 알려주고, 이 조회가 키 없이 동작하는 공개 경로인지도 설명해줘. 인증키 검증 결과와 기관정보 조회 성공을 구분해줘. 기존 로컬 인증 설정을 사용해줘. 실제 인증키는 출력하지 마. 성공·정상 무결과·부분 수집·실패를 구분하고, 원문 저장과 위키 반영은 하지 마.
- 한국원자력의학원과 다른 기관을 식별정보로 구분
- 공시 출처와 규정 첨부 원문을 별도로 확인
- 공개 기관정보 조회 성공을 인증키 유효성 검증으로 표시하지 않기
현재 K-wiki의 institution-search는 키 없이 동작하는 공개 조회 경로를 사용합니다. 기관정보가 반환돼도 인증키 검증 완료로 판단하지 않습니다. 키가 필요한 API는 실제 제공 항목과 명세에 맞는 호출로 별도 확인해야 합니다.
K-wiki 도구 안내: 05_tools/alio_api/README.md
공식 공개 안내·로컬 구현 확인일 2026. 10. 5. · 개인 계정 신청·인증 조회는 별도 확인
준비 자료·검색 조건·결과 예시·확인할 점을 함께 살펴봅니다.
ALIO 타 기관 규정 참고 →국세청 API
계약 상대방이나 거래처의 사업자등록 상태와 과세유형을 확인합니다. 현재 K-wiki 도구는 사업자등록번호로 상태를 조회합니다.
01 · 공식 사이트에서 신청하기
- 공공데이터포털에서 국세청 사업자등록정보 진위확인 및 상태조회 서비스를 활용신청하세요.
- 이 서비스의 승인 상태를 확인하세요. 이미 공공데이터포털 공통키가 있어도 해당 서비스의 승인은 별도로 확인합니다.
- 이미 등록한 DATA_GO_KR_API_KEY 공통키를 그대로 사용하세요. 처음이라면 K-wiki 루트 .env에 한 번만 등록합니다. 확인할 사업자등록번호를 직접 준비해 상태조회 1건을 요청하고, 아래 요청의 대괄호 부분을 조회할 번호로 바꿉니다.
02 · 내 K-wiki에 연결하기
.envDATA_GO_KR_API_KEY심평원·나라장터·국세청은 공공데이터포털 키 하나를 함께 사용합니다. 이미 등록했다면 다시 입력할 필요 없이 이 서비스의 활용신청·승인을 확인하세요. 공통키 한 번 등록하기 →
국세청 설정 준비 요청문
아직 공통키를 등록하지 않았다면 아래 요청으로 한 번만 준비하세요. 세 서비스의 설정 요청문은 같습니다.
K-wiki의 AGENTS.md와 03_skills/17_api_mcp_setup/SKILL.md, 03_skills/17_api_mcp_setup/references/local_config_and_verification.md, 05_tools/hira_api/README.md, 05_tools/g2b_api/README.md, 05_tools/nts_api/README.md를 먼저 읽어줘. 공공데이터포털 인증키 하나를 심평원·나라장터·국세청에서 공통으로 사용할 거야. 루트 .env의 DATA_GO_KR_API_KEY에 한 번만 직접 입력할 수 있도록 설정 파일을 준비해줘. 이미 공통키가 등록되어 있으면 그대로 사용하고, 서비스별 인증키 설정은 추가하지 마. 세 도구가 공통키를 사용하는지 확인하고, 기존 설정과 충돌하면 값 없이 설정 이름과 조치만 알려줘. 기존 설정을 임의로 삭제하거나 덮어쓰지 마. 실제 키는 내가 로컬 파일에 입력할게. 활용신청과 승인은 필요한 서비스마다 따로 확인하도록 안내해줘. 실제 키와 .env 내용은 대화·로그·출력에 표시하지 말고, 다른 위키 문서는 수정하지 마.
03 · 대표 조회로 확인하기
국세청 조회 요청
K-wiki의 05_tools/nts_api/README.md를 먼저 확인해줘. 국세청 도구로 [확인할 사업자등록번호]의 상태를 조회해줘. 사업자등록 상태·과세유형·조회 시점과 조회 성공 여부를 알려줘. 오류를 미등록 또는 폐업으로 해석하지 마. 루트 .env에 한 번 등록한 DATA_GO_KR_API_KEY 공통키를 사용하고, 이 서비스의 활용승인도 확인해줘. 서비스별 인증키 설정은 추가하지 마. 실제 인증키는 출력하지 마. 성공·정상 무결과·부분 수집·실패를 구분하고, 원문 저장과 위키 반영은 하지 마.
- 조회 대상 번호와 성공 여부 확인
- 사업자등록 상태·과세유형·조회 시점 확인
- 조회 오류를 미등록·휴업·폐업으로 해석하지 않기
공식 서비스에는 대표자명·개업일자 등을 대조하는 진위확인도 있지만, 현재 K-wiki 도구는 상태조회 기능입니다. 상태조회만으로 계약 자격 전체나 거래 안전성이 확인되는 것은 아닙니다.
K-wiki 도구 안내: 05_tools/nts_api/README.md
공식 공개 안내·로컬 구현 확인일 2026. 10. 5. · 개인 계정 신청·인증 조회는 별도 확인
준비 자료·검색 조건·결과 예시·확인할 점을 함께 살펴봅니다.
사업자등록 상태 확인 →NTIS API
국가R&D 과제의 후보와 메타정보를 검색합니다. 연구 과제의 기관·연도·주제 등을 좁혀 공식 상세로 이어갑니다.
01 · 공식 사이트에서 신청하기
- NTIS에 로그인하고 회원정보에 소속기관 정보를 등록하세요. 공식 Open API 안내는 소속기관 확인을 거쳐 승인한다고 설명합니다.
- 국가R&D 과제검색 서비스(전체용)의 활용신청을 진행하고 신청 상세의 승인 상태와 승인키를 확인하세요. 서버 IP 등 신청 항목은 실제 호출 환경에 맞게 입력합니다.
- 승인키를 K-wiki 루트 .env에 입력하고 기관명으로 소량 조회하세요. 접근 허용 IP 오류가 나면 신청 상세의 등록 IP와 실제 호출 장비의 공인 IP를 확인합니다.
02 · 내 K-wiki에 연결하기
.envNTIS_API_APPROVAL_KEY이 서비스의 인증값을 사용하세요. 공공데이터포털 공통키로 대체하지 않습니다.
NTIS 설정 준비 요청문
아래 요청을 보낸 뒤 실제 인증키는 로컬 파일에 직접 입력하세요.
K-wiki의 AGENTS.md와 03_skills/17_api_mcp_setup/SKILL.md, 03_skills/17_api_mcp_setup/references/local_config_and_verification.md, 05_tools/ntis_api/README.md를 먼저 읽어줘. NTIS 인증키를 루트 .env의 NTIS_API_APPROVAL_KEY에 직접 입력할 수 있게 기존 설정을 보존하면서 로컬 설정 파일을 준비해줘. 실제 값은 내가 파일에 입력할게. 실제 키와 .env 내용은 대화·로그·출력에 표시하지 말고, 다른 위키 문서는 수정하지 마.
03 · 대표 조회로 확인하기
NTIS 조회 요청
K-wiki의 05_tools/ntis_api/README.md를 먼저 확인해줘. NTIS 도구로 한국원자력의학원 관련 과제를 최대 3건 찾아줘. 검색 조건·과제명·연도·공식 상세 확인 경로와 조회 성공 여부를 보여줘. 허용 IP 오류는 인증키 오류와 구분해줘. 기존 로컬 인증 설정을 사용해줘. 실제 인증키는 출력하지 마. 성공·정상 무결과·부분 수집·실패를 구분하고, 원문 저장과 위키 반영은 하지 마.
- 검색 항목·기관명·연도와 조회 성공 여부 확인
- 과제명·과제 식별정보·공식 상세 확인 경로 확인
- 기관명 변형·공개 시차·누락 가능성을 함께 표시
공공데이터포털 공통키로 NTIS를 대체할 수 없습니다. NTIS 승인키와 접근 허용 IP를 따로 확인하세요. 검색 결과는 과제 후보이므로 일부 결과를 기관 전체 연구 실적으로 단정하지 않습니다.
K-wiki 도구 안내: 05_tools/ntis_api/README.md
공식 공개 안내·로컬 구현 확인일 2026. 10. 5. · 개인 계정 신청·인증 조회는 별도 확인
준비 자료·검색 조건·결과 예시·확인할 점을 함께 살펴봅니다.
NTIS 공개 과제 후보 찾기 →진행이 막혔을 때
키를 다시 발급받기 전에 오류 종류부터 확인하세요.
키가 없다는 메시지가 나와요
올바른 K-wiki 폴더인지, 루트 .env의 해당 서비스 설정 이름이 맞는지, 도구가 로컬 설정을 읽는지 확인하세요. 심평원·나라장터·국세청은 공통 설정 DATA_GO_KR_API_KEY를 확인하세요. 기존 설정이 공통키 사용에 영향을 주는지도 값 없이 점검합니다. 실제 값이나 파일 내용을 출력하지 않고 확인할 수 있습니다.
401 또는 403 오류가 나와요
인증값과 신청 상태, 해당 세부 서비스의 승인 범위를 확인하세요. 403을 키 오타라고 단정하지 말고 승인 범위도 살펴보세요. HTTP 200이어도 API 응답 내부의 오류 여부를 함께 확인합니다.
NTIS에서 접근 허용 IP 오류가 나와요
NTIS 활용신청 상세의 등록 IP와 실제 호출 장비의 공인 IP를 확인하세요. 인증키 오류와 구분하고, 호출 환경을 바꿨다면 등록 정보도 점검합니다.
ALIO 조회가 됐으면 인증키 검증도 끝난 건가요?
기관정보 공개 경로는 키 없이도 조회됩니다. 이 조회 성공을 인증키 검증 완료로 표시하지 말고, 키가 필요한 Open API 호출은 별도로 확인하세요.
시간 초과·연결 오류가 나와요
공식 서비스 공지와 네트워크 연결, 필수 입력값을 확인하고 잠시 후 다시 조회하세요. 같은 실패를 반복 호출하지 않습니다. 급한 확인은 해당 공식 웹에서 진행하고 API 조회 실패를 구분해 기록하세요.
등록했는데 위키가 자동으로 최신 상태가 되나요?
API 등록은 조회 연결을 준비하는 단계입니다. 기존 위키의 자동 갱신을 뜻하지 않습니다. 조회 결과의 최신성·적용 대상·출처를 확인한 뒤 필요한 위키 반영을 별도로 요청하세요.