Desenvolver uma API e muito trabalhoso, deve ter interface intuitiva , simples, fácil de utilizar, entre outros requisitos para temos uma boa API.
Veja as dicas de “Joshua Bloch”, sobre o projeto de uma API:
Joshua Bloch: Notas sobre Design de APIs :
http://www.infoq.com/br/articles/API-Design-Joshua-Bloch
How to Design a Good API & Why it Matters
http://www.infoq.com/presentations/effective-api-design
OBS: Apesar de referir a API pode ser utilizado para o projeto de frameworks
Deixe uma resposta.