Проектирование WebAPI обычно не вызывает никаких проблем, пока не возникает требование унификации.
Под унификацией я понимаю продумывание построение url-ов и возвращаемых результатов таким образом, чтобы они подчинялись общим правилам.
Если хочется понять что это за правила такие, по которым api строится, рекомендую вот этот видос www.youtube.com/live/KS…ed4yyoDM