flâneur — a map of the web's best reading

Ship types, not docs

shiptypes.com · 2,793 words · saved by 1 readers

Types are the contract between services, docs are not

Ship types, not docs Ship types , not docs Types are the contract between services, docs are not by Boris Tane Documentation v2 · 4 months ago POST /api/v2/orders userId : string optional items : Item[] amount : string address : object zipCode : number street : string user_name : string // No mention of required headers // No mention of currency field // Last updated by @sarah (left the company) Implementation v3 · current // requires X-Api-Version header app . post ( '/api/ v3 /orders' , async (req, res) => { const { customerId , items, amount, address, currency } = req.body; //

Explore this link on the map →

saved by

related reading