A great talk on API design, 1h long but worth listening to. Especially the advice,

“Don’t send 6 experts into a room for 6 months to write a spec for an API, start with spec on 1 sheet of paper.”