api design

A few tips to good API design