Avis d'un développeurs: Ne créez pas d'API. Et il sait de quoi il parle, c'est lui qui a travaillé sur l'API GDI de Windows. Pas marrant, visiblement.
Son article lie aussi vers un PDF indiquant les bonnes pratique pour créer une API:
http://lcsd05.cs.tamu.edu/slides/keynote.pdf