Automatisch generierte Hilfeseiten mit dem Rückgabetyp HttpResponseMessage

Ich würde mich über eine Klarstellung der von Web API automatisch generierten Hilfeseiten freuen.

Nach meinem Verständnis wird bei der Rückgabe eines Typs automatisch die Hilfeseite für diese Aktion mit einem Beispiel generiert. Wenn ich jedoch HttpResponseMessage verwende, ist es verständlich, dass es nicht erraten kann, wie die Antwort aussehen wird, und nur Annahmen zu den Anforderungsparametern treffen kann.

Der Grund, warum ich die HttpResponseMessage verwendet habe, war, dass empfohlen wurde, den Statuscode anzugeben, den Sie zurückgeben möchten, wenn er sich möglicherweise von 200 unterscheidet.

SoWas ist der Best-Practice-Ansatz? Sie möchten in der Lage sein, die gewünschten Statuscodes zurückzugeben, haben aber immer noch die Hilfeseiten, die die Typen ausarbeiten, die Sie zurückgeben?

Antworten auf die Frage(3)

Ihre Antwort auf die Frage