4 ms·
You absolutely still need docs on the end point. If you’re interacting with the api then it’s extremely likely you’re not going to write code that will automat
by statictype 7y ago
You absolutely still need docs on the end point.
If you’re interacting with the api then it’s extremely likely you’re not going to write code that will automatically follow reference links and attempt to parse them dynamically.
You will need to know what fields are in the end point how they represent data (iso 8601 for dates? Unix timestamps?).
You’re substituting documentation with asking the api consumer to explore and discover and assume.
- M2Ys4U 7y agoYou need docs about the media type, which is not exactly the same thing. But you've documented how your API works anyway, right?