The Complete Production SOP: How to Deploy and Run Django Ninja Fast Declarative REST APIs with Pydantic in Autonomous AI Agents

---
name: "django-ninja-fastapi-for-django"
description: "Write FastAPI-like high-performance APIs inside Django with automatic OpenAPI docs."
metadata:
  author: "Vitalik"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "write django ninja api"
  - "django ninja pydantic schema"
  - "async endpoint django ninja"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

from django.contrib import admin
from django.urls import path
from ninja import NinjaAPI

api = NinjaAPI(
    title="Production Service API",
    version="1.0.0",
    description="High-performance declarative API with automatic OpenAPI documentation",
    docs_url="/docs"
)

urlpatterns = [
    path("admin/", admin.site.urls),
    path("api/v1/", api.urls),
]

from typing import List
from ninja import Router, Schema
from django.shortcuts import aget_object_or_404
from .models import Product

router = Router(tags=["Products"])

class ProductIn(Schema):
    name: str
    sku: str
    price_cents: int

class ProductOut(Schema):
    id: int
    name: str
    sku: str
    price_cents: int

@router.post("/", response={201: ProductOut})
async def create_product(request, payload: ProductIn):
    product = await Product.objects.acreate(**payload.dict())
    return 201, product

@router.get("/", response=List[ProductOut])
async def list_products(request):
    return [p async for p in Product.objects.all()]

from django.test import TestCase
from ninja.testing import TestClient
from config.urls import api
from store.models import Product

class ProductAPITests(TestCase):
    def setUp(self):
        self.client = TestClient(api)

    def test_create_and_list_product(self):
        payload = {"name": "Test Item", "sku": "TEST-01", "price_cents": 999}
        response = self.client.post("/api/v1/products/", json=payload)
        self.assertEqual(response.status_code, 201)
        self.assertEqual(response.json()["sku"], "TEST-01")

        get_res = self.client.get("/api/v1/products/")
        self.assertEqual(get_res.status_code, 200)
        self.assertEqual(len(get_res.json()), 1)