Проектирование WebAPI обычно не вызывает никаких проблем, пока не возникает требование унификации.

Под унификацией я понимаю продумывание построение url-ов и возвращаемых результатов таким образом, чтобы они подчинялись общим правилам.

Если хочется понять что это за правила такие, по которым api строится, рекомендую вот этот видос https://www.youtube.com/live/KSBed4yyoDM?feature=share