12호출자 확인
- API Key
- Keyless
- 공공데이터포털 인증
- OAuth2
- JWT
- JWS
- HMAC
- Basic
- JWT 발급
- JWT 세션
- 로그아웃 토큰 차단
- 리프레시 토큰 확인
API Gateway · API Management
내부 서비스를 외부 기관과 앱에 API로 열 때 그 앞에 서는 게이트웨이와 관리 콘솔입니다. 키 확인, 호출 한도, 데이터 형식 변환을 게이트웨이 정책으로 처리하고, 이용 기관은 포털에서 활용신청을 해 키를 받습니다. 모든 호출은 거래 로그로 남습니다.
GET /flights200 · 182msGET /exhibitions200 · 210msGET /flights401 · 3msGET /exhibitions429 · 4msGET /members/{id}200 · 240msDELETE /members/{id}405 · 2ms도입 배경
호출 처리
모든 요청은 다섯 단계를 거치고, 거절된 요청까지 같은 형식의 거래 로그로 남습니다. 상황을 골라 보세요.
항공 정보 앱이 기관 플랜으로 항공편 운항 조회 API를 호출
승인된 키 · 기관 플랜
허용된 IP · GET
플랜 한도 안
서버 2대에 나눠 전달 · XML 응답을 JSON으로
응답 시간 · 결과 기록
GET /flightsflight-api-2지자체 포털이 기본 플랜으로 공연 · 전시 정보 조회 API를 호출
승인된 키 · 기본 플랜
허용된 IP · GET
기본 플랜 한도를 넘음
진행하지 않음
거절 사유 기록
GET /exhibitions호출 안 함내부 업무 시스템이 내부 연계 플랜으로 회원 정보 조회 API를 호출
게이트웨이가 발급한 토큰 확인
허용된 IP · GET
플랜 한도 안
서버 1 상태 확인 실패 → 서버 2로 전달
어느 서버로 갔는지 기록
GET /members/{id}member-api-2응답 시간은 전체, 지연 시간은 그중 게이트웨이가 쓴 시간입니다. 응답 시간은 긴데 지연 시간이 짧으면 백엔드가 느린 것이라, 원인이 어느 쪽인지 바로 알 수 있습니다. 거래 로그는 검색하고 엑셀로 내려받을 수 있고, 헤더와 본문은 상세 기록을 켠 API만 남기며 민감한 값은 가리거나 암호화해 저장합니다. 설정을 바꾸고 배포할 때도 누가 언제 무엇을 바꿨는지 변경 이력으로 남습니다.
핵심 기능 1 · 정책
41종의 정책 가운데 필요한 것을 골라 순서대로 붙이면 게이트웨이가 요청과 응답에 차례로 적용합니다. 백엔드 서비스 코드는 고치지 않고, 배포할 때마다 버전이 남아 이전 버전으로 되돌릴 수 있습니다.
핵심 기능 2 · 이용 기관
이용 기관 개발자는 개발자 포털에서 API 문서를 보고 활용신청을 하고, API 담당자는 관리 콘솔에서 승인합니다. 같은 API라도 플랜마다 인증 방식과 한도를 다르게 줄 수 있고, 포털 문서에서 호출 예시와 언어별 클라이언트 코드를 바로 받을 수 있습니다.
개발자가 포털에 자기 앱을 등록합니다.
API 문서를 보고 필요한 플랜을 신청합니다.
API 담당자가 기간을 정해 승인하거나 반려합니다.
승인되면 그 앱의 API Key가 발급됩니다.
호출 한도(quota)는 플랜에 붙이면 구독한 앱마다 API 전체 호출을 세고, API 경로에 붙이면 그 경로의 호출만 셉니다. 두 곳에 나눠 두면 초당 한도와 하루 한도를 함께 걸 수 있습니다.
핵심 기능 3 · AI 에이전트
MegaAPIM은 MCP 서버를 함께 제공합니다. API 담당자가 쓰는 AI 에이전트에 연결하면 API 등록과 배포, 시험 호출, 오류 원인 찾기를 대화로 맡길 수 있습니다. 에이전트는 그 담당자가 콘솔에서 할 수 있는 일만 합니다.
“주문 조회 API를 새로 등록하고 배포해 줘”
API를 등록하고 OpenAPI 문서를 붙인 뒤 게이트웨이에 배포하고, 시험 호출로 응답과 거래 ID를 보여 줍니다.
“어제 오류 난 호출을 찾아서 원인을 알려 줘”
게이트웨이 정책에서 거절됐는지 백엔드가 오류를 냈는지 구분하고, 그 무렵 바뀐 설정이나 배포를 변경 이력에서 찾습니다.
“방금 배포한 API가 모든 게이트웨이에 반영됐는지 확인해 줘”
게이트웨이 노드마다 그 API가 실렸는지 대조하고, 응답이 끊긴 노드나 버전이 다른 노드를 알려 줍니다.
설치
관리 서버를 업데이트하거나 재시작해도 API 서비스는 멈추지 않습니다. 운영자가 바꾼 설정은 관리 저장소에 저장되고, 게이트웨이는 관리 서버를 거치지 않고 저장소에서 직접 읽어 반영합니다.
2026년 11월 기준이며, 제품 개선에 따라 바뀔 수 있습니다.
구축사례
GS 인증 1등급 · 한국정보통신기술협회(TTA) 소프트웨어 품질인증 · 2024년 10월 · 인증번호 24-0520
도입
Swagger 명세, JSON, 엑셀로 가져오고, 명세가 없으면 실제 호출 한 건으로 초안을 만듭니다. 백엔드 서비스는 그대로 둡니다.
인증 방식과 호출 한도를 정해 플랜으로 묶고 게이트웨이에 배포할 수 있습니다.
이용 기관에 키나 토큰을 발급해 API를 호출할 수 있게 합니다.
거래 로그와 대시보드로 사용량을 보고 플랜과 정책을 조정할 수 있습니다.