Ask HN: Best practices (and examples) for designing client libraries for APIs?

I'm writing a client library for my favorite project management app's API, in PHP. Are there any best practices that I can follow? Can you recommend a good example of such a library (either written by the API provider themselves or by a third party) that I can learn from?

Doesn't need to be in PHP - Java, JS etc works too