[waldekmastykarz]

Resolves #2065

devproxy api show now lists the input each endpoint expects, so agents don't have to guess the POST /proxy body or miss the required format query on /proxy/rootCertificate.

Text output:

  GET    /proxy                         Get proxy status
  POST   /proxy                         Update proxy status (e.g. start/stop recording)  body: {"recording": true|false}
  POST   /proxy/mockRequest             Issue a mock request
  POST   /proxy/stopProxy               Stop the proxy
  POST   /proxy/jwtToken                Create a JWT token  body: {"name": "...", "audiences": ["..."], ...} (all optional; validFor in minutes)
  GET    /proxy/rootCertificate         Get the root certificate  query: format=crt (required)
  GET    /proxy/logs                    Get proxy logs (for detached mode access)  query: lines=50&follow=true&since=5m (all optional)

JSON output (--output json) gets matching optional query and body string hints per endpoint (omitted when an endpoint takes no input).

Notes:

• The Docs: https://go.devproxy.net?go=api line from the proposal is left to Print canonical docs shortlinks in --help, api show, and plugin errors #2063, which introduces the shortlinks.
• Kept scoped to hints; structured schemas for JSON output are tracked in devproxy api show --output json: include request and response schemas, or serve an OpenAPI document #2066.

[Copilot]

🟢 Approval recommended

No active review issues were identified in the endpoint input-hint changes.

No open issues 🎉

What changed in this PR

Enhances devproxy api show with endpoint input hints so users and agents can discover expected request bodies and query parameters.

Changes:

• Adds body and query hints to text output and optional body and query fields to JSON output.
• Centralizes endpoint metadata and text formatting.
• Adds tests for recording, certificate, and JWT hints, plus endpoints without input.

File	Description
DevProxy/​Commands/​ApiCommand.cs	Defines input hints and includes them in text and JSON output.
DevProxy.Tests/​ApiCommandTests.cs	Tests endpoint hints and description-only formatting.

_{Review effort: Balanced}