From Dev.to
What to Show Beside an Example API Response
A JSON example can look self-explanatory while leaving the consumer unsure what was requested, which fields are optional and whether the result is complete. Quick answer: Show the relevant input, sche...