Form data

Django Ninja also allows you to parse and validate request.POST data (aka application/x-www-form-urlencoded or multipart/form-data).

Form Data as params

from ninja import NinjaAPI, Form

@api.post("/login")
def login(request, username: Form[str], password: Form[str]):
    return {'username': username, 'password': '*****'}

Note the following:

1) You need to import the Form class from ninja

from ninja import Form

2) Use Form as default value for your parameter:

username: Form[str]

Using a Schema

In a similar manner to Body, you can use a Schema to organize your parameters.

Request form + path + query parameters

In a similar manner to Body, you can use Form data in combination with other parameter sources.

You can declare query and path and form field, and etc... parameters at the same time.

Django Ninja will recognize that the function parameters that match path parameters should be taken from the path, and that function parameters that are declared with Form(...) should be taken from the request form fields, etc.

Mapping Empty Form Field to Default

Form fields that are optional, are often sent with an empty value. This value is interpreted as an empty string, and thus may fail validation for fields such as int or bool.

This can be fixed, as described in the Pydantic docs, by using Generic Classes as Types.