[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79FJS6AJ2VRPRX9JBT4JZKA":3,"skill-same:01M79FJS6AJ2VRPRX9JBT4JZKA":43},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":28,"install":29,"resources":42},"01M79FJS6AJ2VRPRX9JBT4JZKA","skill-fastapi-api",null,"Padrões DARE para APIs REST em Python + FastAPI + Pydantic + uvicorn. Routers, dependency injection, Pydantic v2 schemas, async SQLAlchemy 2.0, autenticação OAuth2 + JWT, rate limit com slowapi, pytest + httpx, OpenAPI auto-gerado.","darelabs-tech\u002Fdare-cli","darelabs-tech","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F297032253?v=4","01M79FCCY9B6SQYRDH94K6BP59","01M79FCCZ8GN6HPPEQJSJYC3FP",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fdarelabs-tech\u002Fdare-cli\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fskill-fastapi-api\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: skill-fastapi-api\ndescription: Padrões DARE para APIs REST em Python + FastAPI + Pydantic + uvicorn. Routers, dependency injection, Pydantic v2 schemas, async SQLAlchemy 2.0, autenticação OAuth2 + JWT, rate limit com slowapi, pytest + httpx, OpenAPI auto-gerado.\n---\n\n# DARE FastAPI Skill\n\nVocê é um desenvolvedor sênior Python especialista em APIs REST com FastAPI. Seu objetivo é gerar código **assíncrono, fortemente tipado (Pydantic v2), com OpenAPI auto-gerado, auth\u002Fautz robustos**, seguindo Layered Design DARE.\n\n## Quando usar\n\n- Projeto FastAPI novo via DARE\n- Adicionar feature em API FastAPI existente\n- Migrar de Flask\u002FDjango para FastAPI\n- Auditar projeto FastAPI para conformidade DARE\n\n## Stack canônica\n\n- **Python 3.11+** com type hints obrigatórios\n- **FastAPI 0.115+** com async\u002Fawait\n- **Pydantic v2** para schemas\n- **SQLAlchemy 2.0** async + **asyncpg** (PostgreSQL)\n- **alembic** para migrations\n- **passlib + argon2** para hash de senhas\n- **python-jose** ou **PyJWT** para JWT\n- **slowapi** para rate limiting\n- **pytest + pytest-asyncio + httpx** para testes\n- **ruff** para lint + format\n- **mypy** para type checking\n\n## Layered Design em FastAPI\n\n```\napp\u002F\n├── main.py                       ← FastAPI app + middlewares\n├── core\u002F\n│   ├── config.py                 ← Settings via pydantic-settings\n│   └── security.py               ← hash, JWT\n├── api\u002F\n│   ├── deps.py                   ← Depends() comuns\n│   └── v1\u002F\n│       ├── users.py              ← Handler (router)\n│       └── auth.py\n├── services\u002F\n│   └── register_user.py          ← Service\n├── repositories\u002F\n│   └── users.py                  ← Repository\n├── models\u002F                       ← SQLAlchemy ORM\n│   └── user.py\n├── schemas\u002F                      ← Pydantic DTOs\n│   ├── user.py\n│   └── auth.py\n└── tests\u002F\n```\n\n## Routers (Handler)\n\n```python\nfrom fastapi import APIRouter, Depends, HTTPException, status\nfrom app.api.deps import get_current_user\nfrom app.schemas.user import UserCreate, UserOut\nfrom app.services.register_user import RegisterUser, UserAlreadyExistsError\n\nrouter = APIRouter(prefix=\"\u002Fusers\", tags=[\"users\"])\n\n@router.post(\"\", response_model=UserOut, status_code=status.HTTP_201_CREATED)\nasync def create_user(\n    payload: UserCreate,\n    service: RegisterUser = Depends(),\n    _current: User = Depends(get_current_user),\n):\n    try:\n        return await service.execute(payload)\n    except UserAlreadyExistsError:\n        raise HTTPException(status_code=409, detail=\"User already exists\")\n```\n\nRegras:\n- Apenas: valida via Pydantic → chama Service → retorna response_model\n- NUNCA: SQLAlchemy direto, lógica de negócio\n\n## Schemas (Pydantic v2)\n\n```python\nfrom pydantic import BaseModel, EmailStr, Field\nfrom datetime import datetime\n\nclass UserCreate(BaseModel):\n    email: EmailStr\n    name: str = Field(min_length=1, max_length=255)\n    password: str = Field(min_length=12)\n\nclass UserOut(BaseModel):\n    id: int\n    email: EmailStr\n    name: str\n    created_at: datetime\n\n    model_config = {\"from_attributes\": True}  # Pydantic v2 \u002F ex-orm_mode\n```\n\n## Services\n\n```python\nfrom app.repositories.users import UsersRepository\nfrom app.core.security import hash_password\nfrom app.schemas.user import UserCreate\nfrom app.models.user import User\n\nclass UserAlreadyExistsError(Exception): ...\n\nclass RegisterUser:\n    def __init__(self, repo: UsersRepository = Depends()):\n        self.repo = repo\n\n    async def execute(self, payload: UserCreate) -> User:\n        if await self.repo.exists_by_email(payload.email):\n            raise UserAlreadyExistsError()\n        return await self.repo.create(\n            email=payload.email,\n            name=payload.name,\n            password_hash=hash_password(payload.password),\n        )\n```\n\n## Repositories (SQLAlchemy async 2.0)\n\n```python\nfrom sqlalchemy import select\nfrom sqlalchemy.ext.asyncio import AsyncSession\nfrom fastapi import Depends\nfrom app.api.deps import get_db\nfrom app.models.user import User\n\nclass UsersRepository:\n    def __init__(self, db: AsyncSession = Depends(get_db)):\n        self.db = db\n\n    async def exists_by_email(self, email: str) -> bool:\n        result = await self.db.execute(select(User.id).where(User.email == email))\n        return result.scalar_one_or_none() is not None\n\n    async def create(self, *, email: str, name: str, password_hash: str) -> User:\n        user = User(email=email, name=name, password_hash=password_hash)\n        self.db.add(user)\n        await self.db.commit()\n        await self.db.refresh(user)\n        return user\n```\n\n## Models (SQLAlchemy)\n\n```python\nfrom sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column\nfrom datetime import datetime\n\nclass Base(DeclarativeBase): ...\n\nclass User(Base):\n    __tablename__ = \"users\"\n    id: Mapped[int] = mapped_column(primary_key=True)\n    email: Mapped[str] = mapped_column(unique=True, index=True)\n    name: Mapped[str]\n    password_hash: Mapped[str]\n    created_at: Mapped[datetime] = mapped_column(default=datetime.utcnow)\n```\n\n## Auth (OAuth2 + JWT)\n\n```python\n# app\u002Fcore\u002Fsecurity.py\nfrom passlib.hash import argon2\nfrom datetime import datetime, timedelta\nfrom jose import jwt\nfrom app.core.config import settings\n\ndef hash_password(p: str) -> str: return argon2.hash(p)\ndef verify_password(p: str, h: str) -> bool: return argon2.verify(p, h)\n\ndef create_access_token(sub: str) -> str:\n    expire = datetime.utcnow() + timedelta(minutes=15)\n    payload = {\"sub\": sub, \"exp\": expire}\n    return jwt.encode(payload, settings.JWT_SECRET, algorithm=\"HS256\")\n```\n\n```python\n# app\u002Fapi\u002Fdeps.py\nfrom fastapi import Depends, HTTPException, status\nfrom fastapi.security import OAuth2PasswordBearer\nfrom jose import jwt, JWTError\nfrom app.core.config import settings\n\noauth2_scheme = OAuth2PasswordBearer(tokenUrl=\"\u002Fv1\u002Fauth\u002Flogin\")\n\nasync def get_current_user(token: str = Depends(oauth2_scheme)) -> User:\n    try:\n        payload = jwt.decode(token, settings.JWT_SECRET, algorithms=[\"HS256\"])\n        sub: str = payload.get(\"sub\")\n    except JWTError:\n        raise HTTPException(status_code=401, detail=\"Invalid token\")\n    # buscar user no DB ...\n    return user\n```\n\n## Rate limiting (slowapi)\n\n```python\nfrom slowapi import Limiter\nfrom slowapi.util import get_remote_address\n\nlimiter = Limiter(key_func=get_remote_address)\napp.state.limiter = limiter\napp.add_middleware(SlowAPIMiddleware)\n\n@router.post(\"\u002Flogin\")\n@limiter.limit(\"5\u002F15minute\")\nasync def login(request: Request, ...):\n    ...\n```\n\n## OpenAPI\n\nFastAPI auto-gera em `\u002Fopenapi.json`. Customize title\u002Fversion\u002Fauth:\n\n```python\napp = FastAPI(\n    title=\"Projeto API\",\n    version=\"1.0\",\n    openapi_url=\"\u002Fopenapi.json\",\n    docs_url=\"\u002Fdocs\",\n    redoc_url=\"\u002Fredoc\",\n)\n```\n\n## Settings (pydantic-settings)\n\n```python\n# app\u002Fcore\u002Fconfig.py\nfrom pydantic_settings import BaseSettings, SettingsConfigDict\n\nclass Settings(BaseSettings):\n    DATABASE_URL: str\n    JWT_SECRET: str\n    JWT_EXPIRE_MINUTES: int = 15\n    model_config = SettingsConfigDict(env_file=\".env\")\n\nsettings = Settings()\n```\n\n## Testes\n\n```python\n# tests\u002Ftest_users.py\nimport pytest\nfrom httpx import AsyncClient\n\n@pytest.mark.asyncio\nasync def test_create_user(client: AsyncClient, admin_token: str):\n    response = await client.post(\n        \"\u002Fv1\u002Fusers\",\n        json={\"email\": \"jane@example.com\", \"name\": \"Jane\", \"password\": \"longsecret123\"},\n        headers={\"Authorization\": f\"Bearer {admin_token}\"},\n    )\n    assert response.status_code == 201\n    assert response.json()[\"email\"] == \"jane@example.com\"\n\n@pytest.mark.asyncio\nasync def test_duplicate_email(client: AsyncClient, admin_token: str):\n    # cria primeiro\n    await client.post(\"\u002Fv1\u002Fusers\", json={...}, headers={...})\n    # tenta de novo\n    response = await client.post(\"\u002Fv1\u002Fusers\", json={...}, headers={...})\n    assert response.status_code == 409\n```\n\n## Antipatterns\n\n| AP | Antipattern | Correção |\n|---|---|---|\n| AP-01 | SQLAlchemy direto no router | Repository injetado via Depends |\n| AP-02 | Validação manual no router | Pydantic schema |\n| AP-03 | Lógica no router | Service |\n| AP-04 | `return user` (ORM) sem response_model | `response_model=UserOut` |\n| AP-05 | Secret hardcoded | `pydantic-settings` + `.env` |\n| AP-06 | Login sem rate limit | `@limiter.limit(\"5\u002F15minute\")` |\n| AP-07 | `password=user.password` em response | `response_model=UserOut` sem password |\n| AP-08 | Sem `from_attributes=True` | response_model não converte ORM |\n\n## Segurança\n\n- Senhas: `argon2.hash()` (passlib)\n- JWT: HS256 com `JWT_SECRET ≥ 32 bytes`, ou RS256 com par de chaves\n- Headers: middleware com HSTS, X-Frame-Options, CSP\n- CORS específico, nunca `*`\n- Rate limit em login + APIs públicas\n- Refresh token com rotação\n\n## CI\n\n```bash\nruff check .\nruff format --check .\nmypy app\npytest --cov=app --cov-fail-under=80\npip-audit\nalembic upgrade head --sql > \u002Fdev\u002Fnull   # valida migrations\n```\n\n## Como aplicar\n\n### Passo 1: Audit\n\n```bash\ngrep -rn \"db\\.execute\\|db\\.query\" app\u002Fapi\u002F        # AP-01\ngrep -rn \"request\\.json()\" app\u002Fapi\u002F               # AP-02\ngrep -rn \"JWT_SECRET\\s*=\\s*['\\\"]\" app\u002F            # AP-05\n```\n\n### Passo 2: Migrar para Pydantic schemas\n\nPara cada `request.json()` ou validação inline → schema Pydantic.\n\n### Passo 3: Extrair Services\n\nLógica > 5 linhas no router → Service injetável.\n\n### Passo 4: Adicionar Repositories\n\nEncapsular SQLAlchemy. Router chama Service via Depends, Service chama Repository.\n\n### Passo 5: Configurar slowapi + auth\n\n`app.add_middleware(SlowAPIMiddleware)` global + `@limiter.limit` em login.\n\n## Dicas\n\n- **Combine** com `dare-docker` (Python 3.11-slim, não-root, multi-stage)\n- **Use** `dare-llm-integration` se houver Gemini\u002FClaude (FastAPI + httpx async)\n- **Para realtime**, FastAPI tem `WebSocket` nativo + `sse-starlette`\n\n---\n\nEsta skill é parte do DARE Method e está sob licença MIT.\n","# DARE FastAPI Skill\n\nVocê é um desenvolvedor sênior Python especialista em APIs REST com FastAPI. Seu objetivo é gerar código **assíncrono, fortemente tipado (Pydantic v2), com OpenAPI auto-gerado, auth\u002Fautz robustos**, seguindo Layered Design DARE.\n\n## Quando usar\n\n- Projeto FastAPI novo via DARE\n- Adicionar feature em API FastAPI existente\n- Migrar de Flask\u002FDjango para FastAPI\n- Auditar projeto FastAPI para conformidade DARE\n\n## Stack canônica\n\n- **Python 3.11+** com type hints obrigatórios\n- **FastAPI 0.115+** com async\u002Fawait\n- **Pydantic v2** para schemas\n- **SQLAlchemy 2.0** async + **asyncpg** (PostgreSQL)\n- **alembic** para migrations\n- **passlib + argon2** para hash de senhas\n- **python-jose** ou **PyJWT** para JWT\n- **slowapi** para rate limiting\n- **pytest + pytest-asyncio + httpx** para testes\n- **ruff** para lint + format\n- **mypy** para type checking\n\n## Layered Design em FastAPI\n\n```\napp\u002F\n├── main.py                       ← FastAPI app + middlewares\n├── core\u002F\n│   ├── config.py                 ← Settings via pydantic-settings\n│   └── security.py               ← hash, JWT\n├── api\u002F\n│   ├── deps.py                   ← Depends() comuns\n│   └── v1\u002F\n│       ├── users.py              ← Handler (router)\n│       └── auth.py\n├── services\u002F\n│   └── register_user.py          ← Service\n├── repositories\u002F\n│   └── users.py                  ← Repository\n├── models\u002F                       ← SQLAlchemy ORM\n│   └── user.py\n├── schemas\u002F                      ← Pydantic DTOs\n│   ├── user.py\n│   └── auth.py\n└── tests\u002F\n```\n\n## Routers (Handler)\n\n```python\nfrom fastapi import APIRouter, Depends, HTTPException, status\nfrom app.api.deps import get_current_user\nfrom app.schemas.user import UserCreate, UserOut\nfrom app.services.register_user import RegisterUser, UserAlreadyExistsError\n\nrouter = APIRouter(prefix=\"\u002Fusers\", tags=[\"users\"])\n\n@router.post(\"\", response_model=UserOut, status_code=status.HTTP_201_CREATED)\nasync def create_user(\n    payload: UserCreate,\n    service: RegisterUser = Depends(),\n    _current: User = Depends(get_current_user),\n):\n    try:\n        return await service.execute(payload)\n    except UserAlreadyExistsError:\n        raise HTTPException(status_code=409, detail=\"User already exists\")\n```\n\nRegras:\n- Apenas: valida via Pydantic → chama Service → retorna response_model\n- NUNCA: SQLAlchemy direto, lógica de negócio\n\n## Schemas (Pydantic v2)\n\n```python\nfrom pydantic import BaseModel, EmailStr, Field\nfrom datetime import datetime\n\nclass UserCreate(BaseModel):\n    email: EmailStr\n    name: str = Field(min_length=1, max_length=255)\n    password: str = Field(min_length=12)\n\nclass UserOut(BaseModel):\n    id: int\n    email: EmailStr\n    name: str\n    created_at: datetime\n\n    model_config = {\"from_attributes\": True}  # Pydantic v2 \u002F ex-orm_mode\n```\n\n## Services\n\n```python\nfrom app.repositories.users import UsersRepository\nfrom app.core.security import hash_password\nfrom app.schemas.user import UserCreate\nfrom app.models.user import User\n\nclass UserAlreadyExistsError(Exception): ...\n\nclass RegisterUser:\n    def __init__(self, repo: UsersRepository = Depends()):\n        self.repo = repo\n\n    async def execute(self, payload: UserCreate) -> User:\n        if await self.repo.exists_by_email(payload.email):\n            raise UserAlreadyExistsError()\n        return await self.repo.create(\n            email=payload.email,\n            name=payload.name,\n            password_hash=hash_password(payload.password),\n        )\n```\n\n## Repositories (SQLAlchemy async 2.0)\n\n```python\nfrom sqlalchemy import select\nfrom sqlalchemy.ext.asyncio import AsyncSession\nfrom fastapi import Depends\nfrom app.api.deps import get_db\nfrom app.models.user import User\n\nclass UsersRepository:\n    def __init__(self, db: AsyncSession = Depends(get_db)):\n        self.db = db\n\n    async def exists_by_email(self, email: str) -> bool:\n        result = await self.db.execute(select(User.id).where(User.email == email))\n        return result.scalar_one_or_none() is not None\n\n    async def create(self, *, email: str, name: str, password_hash: str) -> User:\n        user = User(email=email, name=name, password_hash=password_hash)\n        self.db.add(user)\n        await self.db.commit()\n        await self.db.refresh(user)\n        return user\n```\n\n## Models (SQLAlchemy)\n\n```python\nfrom sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column\nfrom datetime import datetime\n\nclass Base(DeclarativeBase): ...\n\nclass User(Base):\n    __tablename__ = \"users\"\n    id: Mapped[int] = mapped_column(primary_key=True)\n    email: Mapped[str] = mapped_column(unique=True, index=True)\n    name: Mapped[str]\n    password_hash: Mapped[str]\n    created_at: Mapped[datetime] = mapped_column(default=datetime.utcnow)\n```\n\n## Auth (OAuth2 + JWT)\n\n```python\n# app\u002Fcore\u002Fsecurity.py\nfrom passlib.hash import argon2\nfrom datetime import datetime, timedelta\nfrom jose import jwt\nfrom app.core.config import settings\n\ndef hash_password(p: str) -> str: return argon2.hash(p)\ndef verify_password(p: str, h: str) -> bool: return argon2.verify(p, h)\n\ndef create_access_token(sub: str) -> str:\n    expire = datetime.utcnow() + timedelta(minutes=15)\n    payload = {\"sub\": sub, \"exp\": expire}\n    return jwt.encode(payload, settings.JWT_SECRET, algorithm=\"HS256\")\n```\n\n```python\n# app\u002Fapi\u002Fdeps.py\nfrom fastapi import Depends, HTTPException, status\nfrom fastapi.security import OAuth2PasswordBearer\nfrom jose import jwt, JWTError\nfrom app.core.config import settings\n\noauth2_scheme = OAuth2PasswordBearer(tokenUrl=\"\u002Fv1\u002Fauth\u002Flogin\")\n\nasync def get_current_user(token: str = Depends(oauth2_scheme)) -> User:\n    try:\n        payload = jwt.decode(token, settings.JWT_SECRET, algorithms=[\"HS256\"])\n        sub: str = payload.get(\"sub\")\n    except JWTError:\n        raise HTTPException(status_code=401, detail=\"Invalid token\")\n    # buscar user no DB ...\n    return user\n```\n\n## Rate limiting (slowapi)\n\n```python\nfrom slowapi import Limiter\nfrom slowapi.util import get_remote_address\n\nlimiter = Limiter(key_func=get_remote_address)\napp.state.limiter = limiter\napp.add_middleware(SlowAPIMiddleware)\n\n@router.post(\"\u002Flogin\")\n@limiter.limit(\"5\u002F15minute\")\nasync def login(request: Request, ...):\n    ...\n```\n\n## OpenAPI\n\nFastAPI auto-gera em `\u002Fopenapi.json`. Customize title\u002Fversion\u002Fauth:\n\n```python\napp = FastAPI(\n    title=\"Projeto API\",\n    version=\"1.0\",\n    openapi_url=\"\u002Fopenapi.json\",\n    docs_url=\"\u002Fdocs\",\n    redoc_url=\"\u002Fredoc\",\n)\n```\n\n## Settings (pydantic-settings)\n\n```python\n# app\u002Fcore\u002Fconfig.py\nfrom pydantic_settings import BaseSettings, SettingsConfigDict\n\nclass Settings(BaseSettings):\n    DATABASE_URL: str\n    JWT_SECRET: str\n    JWT_EXPIRE_MINUTES: int = 15\n    model_config = SettingsConfigDict(env_file=\".env\")\n\nsettings = Settings()\n```\n\n## Testes\n\n```python\n# tests\u002Ftest_users.py\nimport pytest\nfrom httpx import AsyncClient\n\n@pytest.mark.asyncio\nasync def test_create_user(client: AsyncClient, admin_token: str):\n    response = await client.post(\n        \"\u002Fv1\u002Fusers\",\n        json={\"email\": \"jane@example.com\", \"name\": \"Jane\", \"password\": \"longsecret123\"},\n        headers={\"Authorization\": f\"Bearer {admin_token}\"},\n    )\n    assert response.status_code == 201\n    assert response.json()[\"email\"] == \"jane@example.com\"\n\n@pytest.mark.asyncio\nasync def test_duplicate_email(client: AsyncClient, admin_token: str):\n    # cria primeiro\n    await client.post(\"\u002Fv1\u002Fusers\", json={...}, headers={...})\n    # tenta de novo\n    response = await client.post(\"\u002Fv1\u002Fusers\", json={...}, headers={...})\n    assert response.status_code == 409\n```\n\n## Antipatterns\n\n| AP | Antipattern | Correção |\n|---|---|---|\n| AP-01 | SQLAlchemy direto no router | Repository injetado via Depends |\n| AP-02 | Validação manual no router | Pydantic schema |\n| AP-03 | Lógica no router | Service |\n| AP-04 | `return user` (ORM) sem response_model | `response_model=UserOut` |\n| AP-05 | Secret hardcoded | `pydantic-settings` + `.env` |\n| AP-06 | Login sem rate limit | `@limiter.limit(\"5\u002F15minute\")` |\n| AP-07 | `password=user.password` em response | `response_model=UserOut` sem password |\n| AP-08 | Sem `from_attributes=True` | response_model não converte ORM |\n\n## Segurança\n\n- Senhas: `argon2.hash()` (passlib)\n- JWT: HS256 com `JWT_SECRET ≥ 32 bytes`, ou RS256 com par de chaves\n- Headers: middleware com HSTS, X-Frame-Options, CSP\n- CORS específico, nunca `*`\n- Rate limit em login + APIs públicas\n- Refresh token com rotação\n\n## CI\n\n```bash\nruff check .\nruff format --check .\nmypy app\npytest --cov=app --cov-fail-under=80\npip-audit\nalembic upgrade head --sql > \u002Fdev\u002Fnull   # valida migrations\n```\n\n## Como aplicar\n\n### Passo 1: Audit\n\n```bash\ngrep -rn \"db\\.execute\\|db\\.query\" app\u002Fapi\u002F        # AP-01\ngrep -rn \"request\\.json()\" app\u002Fapi\u002F               # AP-02\ngrep -rn \"JWT_SECRET\\s*=\\s*['\\\"]\" app\u002F            # AP-05\n```\n\n### Passo 2: Migrar para Pydantic schemas\n\nPara cada `request.json()` ou validação inline → schema Pydantic.\n\n### Passo 3: Extrair Services\n\nLógica > 5 linhas no router → Service injetável.\n\n### Passo 4: Adicionar Repositories\n\nEncapsular SQLAlchemy. Router chama Service via Depends, Service chama Repository.\n\n### Passo 5: Configurar slowapi + auth\n\n`app.add_middleware(SlowAPIMiddleware)` global + `@limiter.limit` em login.\n\n## Dicas\n\n- **Combine** com `dare-docker` (Python 3.11-slim, não-root, multi-stage)\n- **Use** `dare-llm-integration` se houver Gemini\u002FClaude (FastAPI + httpx async)\n- **Para realtime**, FastAPI tem `WebSocket` nativo + `sse-starlette`\n\n---\n\nEsta skill é parte do DARE Method e está sob licença MIT.\n",{"name":5,"description":7},"main","3597b5ea0f4e90a0b47e4c036afc7eeb087d5ea5",".agents\u002Fskills\u002Fskill-fastapi-api","https:\u002F\u002Fgithub.com\u002Fdarelabs-tech\u002Fdare-cli","https:\u002F\u002Fgithub.com\u002Fdarelabs-tech","2026-10-23 09:15:53",{"source":8,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add darelabs-tech\u002Fdare-cli --skill skill-fastapi-api",{"tool":35,"command":36},"bunx","bunx skills add darelabs-tech\u002Fdare-cli --skill skill-fastapi-api",{"tool":38,"command":39},"pnpm","pnpm dlx skills add darelabs-tech\u002Fdare-cli --skill skill-fastapi-api","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdarelabs-tech\u002Fdare-cli\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fskill-fastapi-api\u002FSKILL.md",true,[],[44,50,55,62,69,76],{"skillNo":45,"name":46,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":47,"categories":48,"keywords":49,"publishedAt":18},"01M79FRYATNTKSEW78ZF8YPTMP","commands","https:\u002F\u002Fgithub.com\u002Fdarelabs-tech\u002Fdare-cli\u002Fblob\u002Fmain\u002Fbook\u002Fpt\u002Fsrc\u002Fcommands\u002Fskill.md",[],[],{"skillNo":51,"name":46,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":18},"01M79FRX217T58KNDCKKXWRMP1","https:\u002F\u002Fgithub.com\u002Fdarelabs-tech\u002Fdare-cli\u002Fblob\u002Fmain\u002Fbook\u002Fen\u002Fsrc\u002Fcommands\u002Fskill.md",[],[],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":18},"01M79FRS84X15ZCGTK7C2SAMXM","skill-rails-api","Padrões DARE para APIs em Ruby on Rails 8 — API mode, ActiveRecord, Solid Queue, Solid Cable, Action Cable, strong parameters, services (interactors), serializers (Blueprinter\u002FAlba), Devise\u002FJWT, rack-attack, rswag\u002Fgrape-swagger.","https:\u002F\u002Fgithub.com\u002Fdarelabs-tech\u002Fdare-cli\u002Fblob\u002Fmain\u002Fassets\u002Fnpm\u002Fide\u002Fantigravity\u002F.agents\u002Fskills\u002Fskill-rails-api\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":18},"01M79FRN9NQ4DXWBFFPWJF39RA","skill-nestjs-api","Padrões DARE para APIs REST em NestJS + TypeScript + Prisma + Swagger. Modules, Controllers, Services, DTOs com class-validator, Guards, Interceptors, exceções globais, Jest + Supertest, OpenAPI auto-gerado, rate limiting com @nestjs\u002Fthrottler.","https:\u002F\u002Fgithub.com\u002Fdarelabs-tech\u002Fdare-cli\u002Fblob\u002Fmain\u002Fassets\u002Fnpm\u002Fide\u002Fantigravity\u002F.agents\u002Fskills\u002Fskill-nestjs-api\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":18},"01M79FRGSECX4GBGN2X3ZM27TD","skill-mcp-server","Padrões DARE para servidores MCP (Model Context Protocol) em TypeScript ou Python. Define tools, resources, prompts; suporta transports stdio, SSE e HTTP; validação Zod\u002FPydantic; autorização por tool; tracing estruturado; testes; publicação no MCP registry.","https:\u002F\u002Fgithub.com\u002Fdarelabs-tech\u002Fdare-cli\u002Fblob\u002Fmain\u002Fassets\u002Fnpm\u002Fide\u002Fantigravity\u002F.agents\u002Fskills\u002Fskill-mcp-server\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":18},"01M79FRCY80X3GKQ36YTB4TYTQ","skill-go-gin-api","Padrões DARE para APIs REST em Go + Gin (ou stdlib net\u002Fhttp) + sqlc + PostgreSQL. Handlers, services, repositories, middleware, validação com go-playground\u002Fvalidator, JWT, rate limit, swag (OpenAPI), testes com testify e httptest.","https:\u002F\u002Fgithub.com\u002Fdarelabs-tech\u002Fdare-cli\u002Fblob\u002Fmain\u002Fassets\u002Fnpm\u002Fide\u002Fantigravity\u002F.agents\u002Fskills\u002Fskill-go-gin-api\u002FSKILL.md",[],[]]