728x90
반응형

swagger 3

OpenAPI 3.1

개요OpenAPI 3.1은 RESTful API를 명확하고 일관되게 정의하기 위한 오픈소스 명세(Open API Specification)의 최신 버전입니다. 이전 버전인 3.0에 비해 JSON Schema 호환성, 확장성, 유연성이 대폭 강화되었으며, API 문서화, 자동화, 검증, 테스트 등 다양한 API 생명주기 단계에서 핵심 도구로 활용됩니다.1. 개념 및 정의구분내용정의OpenAPI 3.1은 API의 구조, 요청/응답 데이터, 보안 정책 등을 기술하는 명세서로, Swagger에서 발전된 RESTful API 표준입니다.목적개발자, 클라이언트, 시스템 간 API 인터페이스를 명확히 정의하여 상호 운용성과 생산성을 향상시킵니다.필요성API 중심 아키텍처 확산으로 API 정의의 표준화와 자동화 수요가..

Topic 2025.09.17

디지털플랫폼 정부 표준 API 가이드

개요디지털플랫폼 정부 표준 API 가이드는 공공기관이 디지털플랫폼 정부 구현을 위해 서비스 간 데이터·기능을 안전하고 일관성 있게 연계하기 위한 공공 API의 개발·관리·보안 기준을 제공하는 지침서입니다. 행정안전부와 한국지능정보사회진흥원(NIA)이 운영하며, 공공서비스의 민간 개방, 부처 간 협업, 통합 플랫폼 구현을 위한 표준화된 API 구조와 정책 기반 관리방안을 제시합니다.1. 개념 및 정의 항목 설명 비고 공공 API공공기관이 보유한 정보·서비스를 외부 시스템과 연동하기 위해 공개하는 인터페이스RESTful 기반이 원칙목적공공서비스 간 연계성과 민간 개방 활용성 향상디지털플랫폼 정부 서비스 통합 기반적용 대상중앙부처, 지자체, 공공기관, 플랫폼 구축 사업 등API 중계시스템, G-클라우드 연..

Topic 2025.08.05

Contract-First API 테스트

개요Contract-First API 테스트는 API의 동작 구현 이전에 먼저 정의된 명세(Contract)를 기반으로 테스트를 자동 생성하고 검증하는 방식이다. OpenAPI(Swagger), AsyncAPI 등의 사양을 기반으로 요청/응답 구조, 필드 유효성, 에러 처리 등을 사전에 정의하고, 이를 기준으로 테스트 자동화를 수행함으로써 사양 일관성과 서비스 품질을 동시에 확보할 수 있다.1. 개념 및 정의 항목 내용 정의API 동작 구현보다 먼저 작성된 명세(Contract)를 기준으로 테스트 케이스를 생성하고 검증하는 접근 방식주요 도구Postman, Dredd, Schemathesis, Stoplight, Pact 등적용 대상RESTful API, gRPC, GraphQL, 이벤트 기반 API ..

Topic 2025.06.21
728x90
반응형