py-fastapi-patterns
Aplicar Mejores Prácticas de FastAPI
Construir APIs con FastAPI requiere comprender la inyección de dependencias, los modelos de respuesta y el diseño de esquemas OpenAPI. Esta habilidad proporciona patrones probados en batalla que previenen errores comunes y mejoran la experiencia del desarrollador para los equipos de frontend.
下载技能 ZIP
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
开启并开始使用
测试它
正在使用“py-fastapi-patterns”。 Crear un modelo de respuesta paginada para listar evaluaciones
预期结果:
- Definir una clase genérica PaginatedResponse con campos items, total, page y size
- Usar response_model=PaginatedResponse[AssessmentRead] en el endpoint de listado
- FastAPI filtra automáticamente la respuesta para incluir solo los campos de AssessmentRead
- El esquema OpenAPI documentará correctamente la estructura anidada
正在使用“py-fastapi-patterns”。 Agregar middleware CORS a mi aplicación FastAPI
预期结果:
- Importar CORSMiddleware desde fastapi.middleware.cors
- Agregar middleware con allow_origins, allow_credentials, allow_methods y allow_headers
- Agregar middleware CORS temprano en la pila de middleware para el orden apropiado
- Usar orígenes específicos en lugar de comodín (*) en producción
正在使用“py-fastapi-patterns”。 Crear validación para un campo de entrada
预期结果:
- Usar Pydantic Field con parámetros min_length, max_length y description
- Agregar un método field_validator para validar contra valores permitidos
- Lanzar ValueError con un mensaje claro para entradas inválidas
- FastAPI devuelve automáticamente estado 422 en caso de fallo de validación
安全审计
安全Pure documentation skill containing only markdown explanations and Python code examples. No executable scripts, network calls, file system access, or environment variable access. Static findings are false positives triggered by documentation keywords and markdown syntax.
风险因素
🌐 网络访问 (4)
⚙️ 外部命令 (25)
质量评分
你能构建什么
Construir APIs Mantenibles
Aplicar cadenas de dependencias y modelos de respuesta para crear APIs que sean fáciles de mantener y evolucionar con el tiempo.
Mejorar la Integración con Frontend
Diseñar esquemas OpenAPI que generen tipos TypeScript precisos para herramientas de generación de código frontend.
Estandarizar Patrones del Equipo
Establecer manejo de errores consistente y organización de rutas en múltiples servicios API.
试试这些提示
Muéstrame cómo crear una cadena de dependencias en FastAPI para autenticación. Incluye las dependencias get_session, get_current_user y get_current_active_user que puedan usarse en los endpoints.
Explica cómo usar response_model en FastAPI para evitar exponer campos internos como hashed_password. Muestra un modelo User con variantes de lectura y creación.
¿Cómo creo manejadores de excepciones personalizados en FastAPI que devuelvan respuestas de error consistentes con códigos de error? Incluye tanto la clase de excepción como el manejador.
Explica por qué importa el orden de las rutas en FastAPI. Muestra un ejemplo de cómo colocar /users/me antes de /users/{user_id} previene problemas de coincidencia.最佳实践
- Siempre definir rutas específicas antes de rutas parametrizadas genéricas para evitar coincidencias incorrectas
- Usar response_model en cada endpoint para controlar la salida y generar esquemas OpenAPI precisos
- Encadenar dependencias desde la más genérica (sesión) hasta la más específica (usuario_actual) para reutilización
避免
- Omitir response_model expone campos internos como hashed_password en las respuestas de la API
- Colocar rutas genéricas antes de rutas específicas hace que /users/me sea capturado como un parámetro user_id
- Usar cláusulas except desnudas o HTTPException genérico sin códigos de estado crea respuestas de error inconsistentes