These are some reflections on what different products we integrate with provide to users of their APIs. Definitely not meant to be a best practice guide, rather some food for thought if you're building or comparing competing APIs.