19. Про backend документацію. Open API. Swagger. Тести Open API. Json:API vs GraphQL vs REST (UA)
HTML-код
- Опубликовано: 8 сен 2024
- Ви знаєте що робити:
t.me/ssternenko
savelife.in.ua...
prytulafoundat...
Думки про документацію. Чому на проєктах нема документації. Як дешево та легко робити документацію з допомогою Open API. Тести OpenApi в Laravel. hotmeteor/spectator пакет.
develop.bandhe... - текстова версія
00:00 - Привіти
00:37 - Документація це дорого!
02:36 - Код це документація
03:55 - OpenAPI (swagger)
04:40 - PHP8 attributes
05:02 - l5 swagger setup
07:37 - Custom Opi attributes
10:38 - Spectator test Open API specs
10:00 - Використовуй API resources
12:44 - REST vs JSON:API vs GraphQL
Треба зазначити, що все описане у відео (крім PHP8 attributes) підходить для більшості мов\фреймворків, які використовують для роботи із API. Відео варте уваги, якщо розумієте, про що у ньому йдеться)) Дякую!
За інші мови це абсолютно вірно. Тільки не можу бути впевненими чи є можливість писати тести саме по специфікації.
Тести дають величезну додадану вартість написанню специфікації... на жаль без тестів зазвичай OpenAPI дуже швидко стає не актуальним. Ну або дуже жорстке ревью та QA команда...