strive to make the API the best way for clients to consume your data