News for hackers. Stuff that matters.
Re:Using JSON Schema to Document, Test, and Debug APIs by sergiotapia on Monday April 15, 2019 @01:11AM (#19663232)
This seems really verbose? Very XML-y.

What's wrong with simple https://github.com/omniti-labs/jsend

``` { status : "success", data : { "post" : { "id" : 1, "title" : "A blog post", "body" : "Some useful content" } } } ```

Re:Using JSON Schema to Document, Test, and Debug APIs by awwright on Tuesday April 16, 2019 @08:12PM (#19678507)
How is that simple? What does "status" mean? I'm personally familiar with the word "status"—but whatever that property is, I'd have to re-implement it in my user agent, which seems like a waste because my user agent already understands HTTP status codes. How is it simple to have to look at and interpret two different "status" fields? (And that's just the first property!)

What part of the article is verbose? What's wrong with verbose?