API Docs - Typo error on /virtualisation/interfaces/

[Keyhaku]

Issue type

[ ] Feature request
[ ] Bug report
[X] Documentation

Environment

• Python version: 3.6.5
• NetBox version: 2.3.3

Description

Hello,

On the API documentation it seems there is a little error.

On /virtualisation/interfaces/ endpoint, method POST, the field device is marked as mandatory, but the API only respond to the field virtual_machine.

The error message returned by the API is also misleading :

{
 "non_field_errors": [
   "An interface must belong to either a device or a virtual machine."
 ]
}

It seems the error is also present on /virtualisation/interfaces/{id} methods PUT and PATCH.

[k-nishigaki]

I resolved my problem by this report.
thank you so much.

I hope to modified documentation.

[jeremystretch]

My guess is drf-yasg is caching the serializer definition internally by name. Devices and virtual machines each use a unique serializer for interfaces, however both are named InterfaceSerializer.

[lampwins]

This will be covered in #2665