vitalik/django-ninja

어떤 프로젝트인가요?

핵심 기능

• 01타입 힌트를 사용해 Python 함수로 엔드포인트 정의
• 02Pydantic을 통해 요청 매개변수를 검증하고 타입 변환
• 03Swagger UI 및 Redoc 문서를 포함한 OpenAPI 스키마 자동 생성
• 04비동기 뷰 지원
• 05Django 코어 및 ORM과 연동

활용 사례

• 기존 Django 프로젝트에 JSON API 추가
• 자동 생성 API 문서가 필요한 타입 지정 백엔드 서비스 구축
• REST 엔드포인트를 통해 Django ORM 모델 노출

빠른 시작

1. 1

   pip으로 django-ninja를 설치합니다

   pip install django-ninja
2. 2

   urls.py와 같은 디렉터리에 NinjaAPI 인스턴스와 엔드포인트가 포함된 api.py 파일을 만듭니다

3. 3

   urls.py의 urlpatterns에 api.urls를 추가합니다

4. 4

   http://127.0.0.1:8000/api/docs에서 인터랙티브 문서를 엽니다

포함된 컬렉션

토픽

자주 묻는 질문

django-ninja은(는) 무엇인가요?

Django 기반으로 타입 힌트를 활용한 REST API를 구축하는 Python 웹 프레임워크로, OpenAPI 문서와 Pydantic 검증을 자동 생성합니다. Django Ninja는 Django와 Python 타입 힌트로 API를 구축하는 웹 프레임워크입니다. 엔드포인트는 @api.get 같은 라우트 데코레이터를 붙인 일반 Python 함수로 정의하며, 요청 매개변수는 Pydantic을 통해 검증되고 주석에 지정된 타입으로 변환됩니다.

django-ninja은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

django-ninja은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

django-ninja은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. django-ninja의 마지막 커밋은 2026년 11월 6일입니다.

django-ninja은(는) 어디에 사용할 수 있나요?

기존 Django 프로젝트에 JSON API 추가 자동 생성 API 문서가 필요한 타입 지정 백엔드 서비스 구축 REST 엔드포인트를 통해 Django ORM 모델 노출

django-ninja는 어떻게 설치하나요?

pip으로 django-ninja를 설치합니다: pip install django-ninja urls.py와 같은 디렉터리에 NinjaAPI 인스턴스와 엔드포인트가 포함된 api.py 파일을 만듭니다 urls.py의 urlpatterns에 api.urls를 추가합니다 http://127.0.0.1:8000/api/docs에서 인터랙티브 문서를 엽니다

django-ninja은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/vitalik/django-ninja