python-api-development

What it does and when to use it

Build or review an HTTP API implemented in Python. Use when changing FastAPI, Flask, Django REST, request validation, async behavior, persistence, errors, or API tests.

How it works

1. Goal
2. Workflow
3. Decision rules
4. Boundaries
5. Completion standard
6. Further reading

---
name: python-api-development
description: "Build or review an HTTP API implemented in Python. Use when changing FastAPI, Flask, Django REST, request validation, async behavior, persistence, errors, or API tests."
---

# Python API development

## Goal

Implement predictable HTTP behavior with explicit validation, authorization, resource bounds, and dependency handling.

## Workflow

1. Inspect Python version, API framework, dependency manager, ASGI/WSGI setup, schema validation, auth, data layer, and test conventions.
2. Trace request parsing, authentication, authorization, validation, domain operation, persistence, and response serialization.
3. Use framework primitives consistent with the installed version; bound uploads, pagination, remote calls, and background work.
4. Check sync/async boundaries, connection lifetime, transaction behavior, cancellation, errors, and shutdown.
5. Add tests for successful and rejected requests plus relevant dependency failure, authorization, and duplicate-submission cases.

## Decision rules

- Use type hints and validation models at boundaries without treating type checking as runtime authorization.
- Avoid blocking operations on async request paths.
- Use a framework's dependency injection only where it clarifies lifecycle or shared policy.

## Boundaries

- Do not return debug tracebacks or sensitive validation context to clients.
- Do not treat Python typing, CORS, or router concealment as security controls.

## Completion standard

Return the requested artifact or findings with enough evidence for a reviewer to understand what changed, what was checked, and what remains uncertain. Distinguish observed facts, inferred risks, and unverified assumptions. Keep the scope tied to the user's request.

## Further reading

- [Field guide](references/field-guide.md) — use for task-specific review questions and edge cases.
- [Source and rights notes](references/source-notes.md) — use when maintaining this package or reviewing its provenance.

Versions

The database has no other skills named python-api-development.

Database snapshot: 13.11.2026 · package version c749441ca74e (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

• 100python-development
  Professional Python development skill covering modern Python 3.10+, FastAPI, Django, Flask, async programming, data processing, and best practices. Use this skill when developing Python web applications, building FastAPI/Django projects, implementing async programming, or need…
• 100python-development
  Professional Python development skill covering modern Python 3.10+, FastAPI, Django, Flask, async programming, data processing, and best practices. Use this skill when developing Python web applications, building FastAPI/Django projects, implementing async programming, or need…
• 100python-development
  专业的 Python 开发技能，涵盖现代 Python 3.10+、FastAPI、Django、Flask、异步编程、数据处理和最佳实践。使用此技能开发 Python Web 应用、构建 FastAPI/Django 项目、实现异步编程，或需要 Python 架构设计和性能优化指导时使用。
• 90node-api-development
  Build or review an HTTP API implemented on Node.js. Use when changing routes, request parsing, validation, middleware, database access, concurrency, errors, or shutdown behavior.
• 100fastapi
  FastAPI modern Python web framework. Covers routing, Pydantic models, dependency injection, and async support. Use when building Python APIs. USE WHEN: user mentions "fastapi", "pydantic", "async python api", "python rest api", asks about "dependency injection python", "python…
• 100flask
  Flask lightweight Python framework. Covers routing, blueprints, and extensions. Use for simple Python APIs and microservices. USE WHEN: user mentions "flask", "flask blueprints", "python microservice", asks about "flask-restful", "flask extensions", "lightweight python api",…