505760aa8d
* Do not show objects in status "pending" on the UI #784 * Fix peeringdb.js bug introduced in #784 * 500 Error during login for 2FA enabled accounts with unverified email address #996 * Django-Admin: adding a network with existing asn fails with internal error #1035 * Some command-line-tool executions are not logged #1119 * Ops: API throttling of repeated requests #1126 * Ops: response header X-Auth-ID to augment logging #1120 * Allow rate-limiting of melissa enabled api functionality. #1124 * State / Province normalization #1079 * Log melissa requests #1122 * remove debug messages * bump django-handleref to 1.0.2 * Need consolidated app logs #845 * pin django peeringdb to 2.13 and relock poetry * pin django-restframework-apikey to 2.1.0 * linting * migrations * docs regenerate * docs * linting Co-authored-by: David Poarch <dpoarch@20c.com> Co-authored-by: Stefan Pratter <stefan@20c.com>
2.7 KiB
Generated from api_schema.py on 2022-04-12 16:41:02.631987
peeringdb_server.api_schema
Augment REST API schema to use for open-api schema generation.
open-api schema generation leans heavily on automatic generation implemented through the django-rest-framework.
Specify custom fields to be added to the generated open-api schema.
Classes
BaseSchema
BaseSchema(rest_framework.schemas.openapi.AutoSchema)
Augments the openapi schema generation for the peeringdb API docs.
Methods
augment_create_ix
def augment_create_ix(self, serializer, model, op_dict)
Augment openapi schema for create ix operation.
augment_create_operation
def augment_create_operation(self, op_dict, op_args)
Augment openapi schema for object creation.
augment_delete_operation
def augment_delete_operation(self, op_dict, op_args)
Augment openapi schema for delete operation.
augment_list_filters
def augment_list_filters(self, model, serializer, parameters)
Further augment openapi schema for object listing by filling the query parameter list with all the possible query filters for the object.
augment_list_operation
def augment_list_operation(self, op_dict, op_args)
Augment openapi schema for object listings.
augment_retrieve_operation
def augment_retrieve_operation(self, op_dict, op_args)
Augment openapi schema for single object retrieval.
augment_update_fac
def augment_update_fac(self, serializer, model, op_dict)
Augment openapi schema for update fac operation.
augment_update_ix
def augment_update_ix(self, serializer, model, op_dict)
Augment openapi schema for update ix operation.
augment_update_net
def augment_update_net(self, serializer, model, op_dict)
Augment openapi schema for update net operation.
augment_update_operation
def augment_update_operation(self, op_dict, op_args)
Augment openapi schema for update operation.
get_classes
def get_classes(self, *op_args)
Try to relate a serializer and model class to the openapi operation.
Returns:
- tuple(serializers.Serializer, models.Model)
get_operation
def get_operation(self, *args, **kwargs)
Override this so we can augment the operation dict for an openapi schema operation.
get_operation_id
def get_operation_id(self, path, method)
Override this so operation ids become "{op} {reftag}"
get_operation_type
def get_operation_type(self, *args)
Determine if this is a list retrieval operation.
request_body_schema
def request_body_schema(self, op_dict, content=application/json)
Helper function that return the request body schema for the specified content type.