I wouldn't call it a best-practice, but I've done this. I guess my basic heuristic is that it's decent for an API that you expect to have very few consumers (i

I wouldn't call it a best-practice, but I've done this. I guess my basic heuristic is that it's decent for an API that you expect to have very few consumers (internal, partnerships), but I would hesitate to recommend them for an API aiming for wide adoption.