Your question is API Expectations for Developers. Take a moment with it on the right.
Talk me through your thinking if you like. When you're confident, submit your answer and I'll grade it like a real screen (7/10 or better passes).
What would you expect an API to be like as an external developer that uses it?