È capitato abbastanza di rado, e l'ultima volta è fallito tutto (ma perché il cliente era un imbecille, non per le nostre API ), per cui non credo di poter dare consigli troppo validi tanto credo dipenda molto dal tipo di applicazione e di target di utilizzo delle API - un conto è se è un progetto pilota per un singolo cliente con API fatte su misura per lui, un altro è se sono Twitter e devo fare API per il pubblico generale. Tu in che caso rientri?
In realtà sono in una categoria a parte visto che l'azienda per cui lavoro (Apiary) sviluppa strumenti per API Design, e non molto tempo fa ho parlato a Londra di cosa c'è di sbagliato nelle metodologie di design correnti. Avrei piacere se potessi vederlo e dirmi se ti trovi con le mie tesi!