Большой текст про программные интерфейсы APIs as ladders (ссылку нашел у разработчиков OpenAI API).

Основная идея: сложная часть работы с API - его изучение, а не непосредственное использование. Да и вообще, разработчики не хотят разбираться с вашим API. Они хотят решить некоторую проблему и двигаться дальше. Но после решения простой задачи (первая ступень) может потребоваться сделать нечто чуть более сложное. И высота второй ступени может существенно отличаться от высоты первой. А потом приходит время еще более сложных задач...
В общем, почитайте, рекомендую