topic Comparing GET /network-device and GET /network-device/location in Controllers https://community.cisco.com/t5/controllers/comparing-get-network-device-and-get-network-device-location/m-p/3487559#M1488 <HTML><HEAD></HEAD><BODY><P>This is an observation, that could perhaps lead to better documentation.</P><P></P><P>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.</P><P></P><P>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.</P><P></P><P>It might, then, be appropriate to document that the GET /network-device returns a structure of type NetworkDeviceDTO.</P><P></P><P>Regards</P><P></P><P>Nathan </P></BODY></HTML> Fri, 01 Mar 2019 12:30:12 GMT Nathan Sowatskey 2019-03-01T12:30:12Z Comparing GET /network-device and GET /network-device/location https://community.cisco.com/t5/controllers/comparing-get-network-device-and-get-network-device-location/m-p/3487559#M1488 <HTML><HEAD></HEAD><BODY><P>This is an observation, that could perhaps lead to better documentation.</P><P></P><P>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.</P><P></P><P>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.</P><P></P><P>It might, then, be appropriate to document that the GET /network-device returns a structure of type NetworkDeviceDTO.</P><P></P><P>Regards</P><P></P><P>Nathan </P></BODY></HTML> Fri, 01 Mar 2019 12:30:12 GMT https://community.cisco.com/t5/controllers/comparing-get-network-device-and-get-network-device-location/m-p/3487559#M1488 Nathan Sowatskey 2019-03-01T12:30:12Z