Добавить в курс проектирование API

[pelid]

При проектировании API программисты часто сталкиваются с такими сложностями:

• На какие API endpoints лучше разбить функциональность API, где и как проложить границу между ними?
• Из каких структур данных сложить запрос/ответ к API?
• Какие схемы выносить в реиспользуемые типы? Как их сделать по-настоящему реиспользуемыми?
• Чем схема запрос/ответ API отличается от типов данных API?
• Как организовать структуру каталогов и файлов?
• Как спроектировать схему данных по концептам Product Flow?
• Как написать концепты Product Flow по уже существующей схеме данных?
• Как всего этого добиться средствами Pydantic и FastAPI/Django Ninja?
• О чём писать во встроенной документации к API и куда её класть?
• Какие выбрать способы аутентификации?
• Как разделить аутентификацию и авторизацию?

Вопросов много, освоить всё это по ходу дела тяжёло. При этом навык проектирования API крайне востребован -- страшно пускать бэкендера пилить новые API endpoints, если ему не хватает навыков.