Skip to content

Documentation Index

Welcome to APIFlask's documentation!

Versions

  • Latest: The docs for the latest source code on GitHub.
  • V1: The docs for the latest 1.x release.

Contents

Go through the following chapters to learn how to use APIFlask:

  • Introduction: A general introduction for APIFlask.
  • Migrating from Flask: Migrating guide and notes.
  • Basic Usage: Get started with APIFlask.
  • Request Handling: The detailed introduction of the @app.input decorator.
  • Response Formatting: The detailed introduction of the @app.output decorator.
  • Data Schema: Introduce how to write an input/output data schema.
  • OpenAPI Generating: Introduce how the OpenAPI generation works and how to customize it with @app.doc decorator and configuration variables.
  • Authentication: Introduce how to implement authentication support for your application.
  • API Documentation: Introduce the usage and configuration of the API documentation tools.
  • Configuration: A list of all the built-in configuration variables
  • Examples: A collection of application examples.
  • Tips: A collection of best practices and notes for web API development with APIFlask.

The following chapters are useful for contributors and who want to know more about APIFlask:

External Documentations

I will try to cover all the basic usages in APIFlask's documentation. However, for advanced usages, you may need to read the documentation of the framework, tools that APIFlask based on:

  • Flask: The knowledge of Flask is required.
  • marshmallow: Advanced reference for schema.
  • Flask-HTTPAuth: Advanced reference for the usage of HTTPBasicAuth and HTTPTokenAuth.
  • webargs: Useful for contributors.
  • apispec: Useful for contributors.
  • OpenAPI: The OpenAPI Specification.
  • JSON Schema: Useful when you want to set a custom error schema and you don't want to use schema class.