9.34System API granularity
Too fine-grained:
GET /account-name
GET /account-phone
GET /account-city
Then consumers need three calls.
Too coarse:
GET /dump-entire-salesforce-account
with 300 fields.
Better:
GET /customers/{id}
with an intentionally designed resource representation.
API design fundamentals still apply.