API 조회를 업무에 연결하기
등록한 API로 무엇을 조회하고 어떤 결과를 확인하는지 배웁니다.
K-wiki 자료 확인일 2026. 10. 5. · 요청문과 결과 표는 교육용 예시입니다.
언제 쓰나요?
API 등록은 끝났는데 실제 질문에 어떤 서비스를 사용하면 좋을지 궁금할 때 읽으세요.
준비할 자료
- 필요한 API의 활용승인과 로컬 설정
- 검색할 기관·기간·항목
- 국세청 조회라면 사용자가 준비한 조회 대상 번호
아래 요청문은 K-wiki 폴더를 연 AI 도구에 붙여 넣으세요. 대괄호 안의 내용은 실제 상황에 맞게 바꿉니다.
먼저 이해하기
서비스마다 반환하는 정보가 다릅니다
법령 API는 법령과 시행일 확인, 심평원은 의료기관 공개정보, 나라장터는 공고·계약 등의 공개정보, ALIO는 공공기관 정보와 공시 탐색에 활용합니다. 국세청 도구는 사업자등록 상태, NTIS는 국가R&D 과제 후보를 조회합니다. 검색 조건과 제공 범위를 먼저 정하세요.
한 공통키로 승인된 서비스를 사용합니다
심평원·나라장터·국세청은 DATA_GO_KR_API_KEY 하나를 사용하며 필요한 서비스의 승인은 각각 확인합니다. 법령 OC·ALIO·NTIS는 별도입니다. 조회에 성공해도 기관 적용 판단이나 계약 자격 전체가 확정되지는 않습니다. ALIO 공개 기관정보 조회 성공은 인증키 검증과 구분합니다.
진행 순서
- 업무에서 확인할 정보를 정해 API를 선택합니다.
- 설정과 해당 서비스의 활용승인 상태를 확인합니다.
- 기간·기관·건수를 좁혀 대표 조회를 요청합니다.
- 조회 상태·조건·시점·출처와 미확인 항목을 받습니다.
따라 할 요청문
먼저 화면에서 확인할 범위를 정하고 시작합니다.
AI에게 이렇게 요청하세요
K-wiki에서 [확인할 정보]에 맞는 API와 도구 안내를 확인해줘. 필요한 검색 조건을 먼저 정리하고, 등록된 로컬 설정으로 소량 조회해줘. 키는 출력하지 말고 성공·정상 0건·부분 수집·실패를 구분해줘. 원문 저장과 위키 반영은 하지 마.
어떤 결과를 확인하나요?
표의 형식을 참고하세요. 실제 규정 검토나 인증 조회를 실행한 결과가 아닙니다.
| 결과 | 해석 |
|---|---|
| 성공·결과 있음 | 기관 식별·조회 시점·항목 의미 확인 |
| 성공·0건 | 검색 조건과 서비스 제공 범위 확인 |
| 일부 수집 | 전체 목록으로 표현하지 않기 |
| 인증·연결 실패 | 자료 없음이나 폐업으로 해석하지 않기 |
이어서 요청하기
결과를 검토한 뒤 필요한 범위만 이어서 요청하세요.
이 결과에서 사실로 확인된 정보와 업무 적용을 위해 추가로 확인할 기준을 나눠줘.
확인할 점
- 공통키를 서비스별로 다시 등록하지 않았는가?
- 조회 성공과 적용 판단을 구분했는가?
- 오류를 정상 결과로 해석하지 않았는가?
확인한 K-wiki 자료와 검증 범위
K-wiki/README.mdK-wiki/AGENTS.mdK-wiki/02_wiki/index.mdK-wiki/03_skills/17_api_mcp_setup/SKILL.mdK-wiki/05_tools/README.md
지침·색인·도구 안내를 대조해 교육용으로 재작성했습니다. 개인 계정 신청·API 실조회·규정의 최종 적용 판단·사용자 PC의 문서 생성 성공은 이번 교육 페이지 작성에서 검증하지 않았습니다.