This is an observation, that could perhaps lead to better documentation.
The GET /network-device/location API is documented as returning a list of NetworkDeviceDTO. Note that it only returns something in the results if there actually are devices that have locations.
The GET /network-device does not have a documented return type. It looks like, in practice, the structure of what is returned is the same as that of the NetworkDeviceDTO.
It might, then, be appropriate to document that the GET /network-device returns a structure of type NetworkDeviceDTO.
Please sign in to leave a comment.