Насколько я знаю, наиболее популярной парадигмой создания API на данный момент является
REST
Об опыте создания API на вскидку нашёл следующие статьи:
1,
2.
По опыт скажу, что тут важнее всего грамотно всё спланировать. Найдите проект по возможности сходный с Вашим целевым который предоставляет документацию по своему API, и почитайте её.