Too Long; Didn't Read
API design is a difficult topic. A lot of people have opinions about it and also nearly all of those people who have opinions are the <strong>wrong</strong> people to ask about it. Since you are reading an article about APIs it is fairly safe to assume that you already have at least some opinions about it already. You are perhaps here to read my screed against GraphQL or REST or similar topic, but I am going to disappoint you there.