Я понимаю что это перевод, но очень очень кратко - тема совсем не раскрыта автором. Про один JSON в качестве API можно книгу написать. А как же Json Schema, hateoas, JSON-RPC, GraphQL
Там цикл статей, во второй главе чуть больше информации по обозначенным вами темам, В третьей главе, читатель продолжает знакомиться с API на конкретном примере
Глава 3: Типы и форматы API