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