Return flat JSON instead of transformed data

[snipe]

In a previous PR, we updated the update() method of the API assets controller to use the standard asset payload return. This unfortunately broke some integrations with Kandji2Snipe and Jamf2Snipe, as those are expecting the old (incorrect) flat object shape.

This is a temporary fix, as I think the API object return shape should conform with the way we return it everywhere else, but this should at least get people who use Kandji2Snipe and Jamf2Snipe back up and running.

Big thanks to @uberbrady, @ctsamuraix, @ParadoxGuitarist, and @mcarras8 for working through the issue with us.

The longer term plan will be to correct those scripts to use the "right" API object return shape, and/or allow you to opt into using the new one if for some reason you can't update your own integrations.

This should fix grokability/jamf2snipe#134

[what-the-diff]

PR Summary

• Refined Return/response in 'AssetsController.php'
  Updated the 'AssetsController.php' to provide a more raw and direct result when calling the 'update' function. This improves consistency across both successful and warning messages.
• Enhanced In-code Documentation
  Additional comments have been added to outline the rationale behind the changes, and proper instructions indicating what the return type should normally be. This ensures that the changes can be easily understood by other developers working on the project in the future.

[uberbrady]

I know it sucks to have to revert the more 'correct' version here, but I agree with you that it's the right move for right now. We'll get back to looking at this properly soon.