If you have not have already read the characteristics of a good API, you may do so in “Why To Design a Good API.”
As discussed in the above-mentioned article, API is almost permanent and once distributed, should not be modified. You have got one chance to make it right.
One of the most important challenges in the world of software design is designing a good API . Prominent software product development organizations are known for their wide developer network, extensive and helpful documentation, good support services and obviously: products that are worthwhile. Interestingly, a common thing between all these organizations is a “good product API” (stress: good).