Сомнительное утверждение. Бот апи у них вполне человечески описан. По крайней мере был. Клиентское апи тоже имеет документацию принципиально описывающую механизмы. А вот для сотен методов у них там адская портянка на специальном языке для типа автоматеской генерации клиентов. Короче имхо телеграм плохой пример. У них может быть плохо задокументировано клиентское апи, но точно нет подхода "скачайте нашу либу".
При этом в общем-то к телеге в этом смысле претензий чуть меньше: они всё-таки и авторы и реализаторы.
В отличии от гугла с OAuth