FastAPI Development Standards

This skill guides development of FastAPI endpoints for the E-Signature Platform API.

Endpoint Implementation Checklist

1. Pydantic Models: Always define request/response schemas in app/schemas/
2. Error Handling: Use error codes from esig-design.md Error Code Catalog
3. Authentication: Use get_current_user dependency for protected routes
4. Validation: Implement constraints from esig-design.md (e.g., name 1-255 chars)
5. Idempotency: Create endpoints accept Idempotency-Key header
6. Tests: Write success, validation error, and auth error test cases

Error Response Format

All errors must follow the standard format from esig-design.md:

from fastapi import HTTPException