Designing APIs for humans: Object IDs

This reminds me of the debate whether part numbers should have a human readable prefix (category) or not. In the arguments in the above article match many of the arguments I’ve made for a prefix in part numbers. Semi-structured identifiers are a pragmatic solution.

Stripe is well known for having a very nice and well documented API.