News for hackers. Stuff that matters.
Re:Show HN: Insomnia Designer – Open-source collaborative ed... by gumby on Wednesday April 29, 2020 @04:09PM (#23023581)
Can someone help an old fart here? When I think of "API" I think of, say sections 2 and 3 of the unix man pages. Calling conventions basically. When I write a library I don't need a special tool -- the functions and data structures in my external .h files by definition define the API.

This tool is clearly for something related to that (how you call a remote web web service) and clearly people find it, and tools like it valuable. But I don't get it.

This isn't me saying "you kids are dummies for needing this thing" -- I'm asking the opposite: "I don't get it: what important things am I not understanding?"

Re:Show HN: Insomnia Designer – Open-source collaborative ed... by rojoca on Wednesday April 29, 2020 @05:27PM (#23024572)
A web service can provide a schema similar to a header file to define its API but there is no "standard" format for this schema, nor is there a standard location to look for such a thing.

You can of course provide your own schema. This tool lets you design an API for a web service in a popular schema format called OpenAPI.

Re:Show HN: Insomnia Designer – Open-source collaborative ed... by gumby on Wednesday April 29, 2020 @06:00PM (#23024936)
Thanks
Re:Show HN: Insomnia Designer – Open-source collaborative ed... by mikejulietbravo on Wednesday April 29, 2020 @06:03PM (#23024964)
Agree - appreciate the clarity of the answer.