Открою секрет: почти никто не умеет в дизайн апи. Хороший апи бывает редко и не с первого раза (разве что он тривиальный).
Кому-то твой апи понравится, кому-то его будет мало, кому-то будет слишком много лишнего. Начинать надо с того же, с чего и всегда — выяснения целевой аудитории. Для чего оно будет использоваться и кем.
Почитай о том, как пишутся спецификации, почитай что-то по бизнес-анализу, системному мышлению, ТРИЗ.
Ну и делай, а потом переделывай, смотри свой старый код, смотри, как его используют.