News for hackers. Stuff that matters.
Re:Ask HN: What REST APIs, in your opinion, deserve an award? by JoshuaDavid on Sunday December 29, 2019 @03:16AM (#21904770)
Twilio: consistent, well-documented, as simple as needed for the problem space but no simpler. As an example of "as simple as possible but no simpler" and also "well-documented", see "What the heck is a segment"[1]. Basically, plain SMS messages can be 160 bytes each, and if you want to send more than that, you have to send a multi-segment message, which sends multiple messages with a common header, which the receiver of the message reassembles into what looks like a single message. If you send a message with > 160 chars, or with non-GSM chars, it will "just work" but if you're optimizing for cost they still show you which encoding is used / how many segments so you can fiddle with that if you need to).

[1] https://www.twilio.com/blog/2017/03/what-the-heck-is-a-segme...

There are no comments on this comment yet.