Best practices for REST API design (2020)

Re:Best practices for REST API design (2020) by Alex3917 on Monday February 22, 2021 @06:17PM (#26231980)

This. Just because something contains numbers doesn't mean that it's numeric. Times aren't numbers because 6pm * 7am doesn't yield a meaningful result.

Same thing with serial numbers, VIN numbers, building floor numbers, phone numbers, etc. All of those should always be strings, because performing "math" on them wouldn't yield meaningful results.

[ Parent | on HN ]

Re:Best practices for REST API design (2020) by chrisandchris on Tuesday February 23, 2021 @06:32AM (#26236106)

While I basically agree, there‘s a difference between „always send numbers as string“ and „send something that looks like a number but is actually a string as a string“.

Why should i send a dimension as a string? How am I going to calculate the volume from 3 strings?

[ Parent | on HN ]

Re:Best practices for REST API design (2020) by Alex3917 on Tuesday February 23, 2021 @08:53AM (#26237210)

> Why should i send a dimension as a string?

You shouldn't because a dimension is a number. Something 4 feet long is twice as long as something 2 feet long.

[ Parent | on HN ]

Re:Best practices for REST API design (2020) by MaxDPS on Tuesday February 23, 2021 @02:50AM (#26234815)

I work in ecommerce and deal with this issue a TON. I see it in things like GTIN/UPC or tracking numbers.

[ Parent | on HN ]