Самое первое API, с которым я познакомился и который я хорошо изучил - API Вк. Мне оно очень нравится (не идеальное, но хорошее), достаточно удобное.
Сейчас я приступил к созданию API своего сервиса. Насколько будет правильно\законно копировать модель API? Не точно, конечно, но очень похоже.
В Telegram строится API аналогичным образом, вопрос только в том подойдёт ли оно вам. Может вам нужны серьёзные вещи вроде GraphQL, или базовый RESTFull. Но в подражании нет ничего плохого, если ваш сервис например будут использовать люди знакомые уже с ВКонтакте API.
