时间戳

首页 > 解决方案 > 如何在 DRF Docs 中描述查询参数？

python - 如何在 DRF Docs 中描述查询参数？

问题描述

我正在使用 Django REST Framework v3.9 内置交互式文档。
我有一个 url 需要查询参数来获取。例如： ../jobs/?order_choice=0&city=1&region=0 但我不知道如何在交互式文档中记录它。

我method:用来添加参数：如：

class JobListView(APIView):
    """
    get:
    - order_choices
    - city
    - region
    - job_type
    """

但它打印在一行中

- order_choices - city - region - job_type

这是我的参数/

    params_data = {
        'city': request.query_params.get('city', None),
        'region': request.query_params.get('region', None),
        'job_type': request.query_params.get('job_type', None),
        'status': 1,
    }

我想知道如何正确记录它。

标签： pythondjangodjango-rest-framework

解决方案

试试下面的东西......

class PackageViewSet(viewsets.ModelViewSet):
"""
** Query Parameters **

    `page` - get data of a particular page.

    `page_size` - change total objects in a page (default=20).

** Filter Parameters **

    `status` - `1/2`

** Search Parameters **

    `name` - `search by package name`

** Ordering Parameters **

    `name`

    `created_at`

    `updated_at`

** Default Ordering **

    `-created_at`

`Method Allowed`

    `GET -` `Lists all the Packages of a facility/company.`

    `POST -` `Creates Package for a facility.`

    `PUT -` `Updates a Package.`

    `DELETE -` `deletes a Package.`

`POST/Create, PUT/Update`

    {
        "name": "package one",
        "description": "package one",
        "status": 1    // 1- Active, 2-Inactive
    }
"""

推荐阅读