본문 바로가기

Swagger2

🧾 Django REST Framework에서 API 문서 자동화하기 (DRF Spectacular + Swagger) 💡 왜 API 문서가 중요할까?API는 개발자들이 사용하는 제품입니다.좋은 API를 만든다고 해도, 사용법을 모르면 쓸 수 없겠죠?“API는 문서화된 만큼만 가치가 있다.”어떤 endpoint가 있는지어떤 method(GET, POST 등)가 가능한지어떤 데이터를 주고받는지인증은 어떻게 하는지이런 내용이 없다면, 그 API는 사용자가 없는 앱과 다를 바 없습니다.🧪 TDD로 Django 프로젝트를 개발 중이번 강의는 Django 심화 과정이었고, TDD(Test-Driven Development) 방식으로 API를 하나씩 만들고 있습니다.예를 들어 POST /recipes/나 GET /tags/와 같은 API를 만들고 테스트로 검증하죠.그런데 기능이 많아지면서, 내가 만든 API를 외부 개발자나 팀원.. 2025. 8. 6.
🔌 API란 무엇일까? 쉽게 풀어보는 API의 개념과 동작 원리 📌 1. API란?API는 Application Programming Interface의 줄임말로,“소프트웨어끼리 소통하게 해주는 통로”라고 생각하면 됩니다.쉽게 말해,"내가 만든 프로그램이 다른 프로그램에게 말을 걸고, 응답을 받는 방식"예를 들어:내 앱에서 날씨 정보를 가져오고 싶다 → 날씨 API 요청웹사이트에서 카카오 로그인을 하고 싶다 → 카카오 로그인 API 사용쇼핑몰에서 결제를 처리하고 싶다 → 결제사 API 연동즉, API는 외부의 기능을 내 서비스에서 쉽게 활용할 수 있도록 해주는 다리입니다.⚙️ 2. API는 어떻게 동작할까?API는 보통 클라이언트(요청)와 서버(응답) 사이에서 이렇게 작동합니다:[내 프로그램] → 요청(Request) → [API 서버] .. 2025. 8. 6.