Чтобы понимать, какие запросы можно отправлять в GraphQL API и что можно получить в ответе, нужно уметь читать его схему. Это как WSDL в SOAP API — описание всех доступных методов.
Да, программы типа Postman или Apollo сами считывают схему и показывают вам всё в красивом виде — просто ходи да «натыкивай» запросы. Но если само API ещё в разработке, чтение схемы поможет понять, что вас ожидает.
Поэтому в этой статье я расскажу, что такое Schema GraphQL API и как её читать.
Если открыть GraphQL API в Apollo Studio, мы увидим документацию по методам. Посмотрим на примере системы Cards, ссылка в Apollo — https://cards.bugred.ru/online.
Чтобы документация появилась, нужно вызвать первый запрос с авторизацией — система защищена, без заголовка Authorization ничего не вернет (пароль см в документации по ссылке выше). Можно послать универсальный запрос: query UniversalQuery { __typename}
И вот мы видим, какие вообще методы нам доступны. Посмотрим на запросы Query:
Зайдем в любой метод, например, в метод getUser. И смотрите, у возвращаемого объекта есть описание на русском! «Тип данных пользователь»:
В GraphQL для поля любого объекта вы можете указать аргументы. А объект — это который определяется через ключевое слово type:
Однако обычно аргументы используют в запросах — query и mutation (это тоже объекты в схеме). Там всё логично:
Чит-лист — это шпаргалка по выбранной теме, что не забыть проверить. Берете чит-лист как основу, адаптируете под свой проект, и готово!
В своей книге про тест-дизайн я написала ряд чит-листов, которыми и хочу теперь поделиться. Сегодня поговорим про очень важную тему — одновременное использование. Если говорить про веб-приложение, то это одновременная работа в двух вкладках браузера.
Если в приложении есть возможность открыть одну и ту же форму несколько раз — это обязательно надо проверить:
Веб — открыть форму в нескольких вкладках браузера.
Десктоп — там тоже иногда можно открыть в отдельной вкладке форму. Или запустить приложение несколько раз (имитируя разных пользователей).
Мобилки — открыть с разных устройств.
Параллельное выполнение одинаковых действий часто ломает систему. Поэтому обязательно проверяем. Тем более что совместная работа — вполне распространенный кейс работы с программой. Те же гуглодоки для того и нужны, чтобы работать с ними вместе или самому с разных компьютеров.
Пройдемся по операциям CRUD (create, read, update, delete) и посмотрим на чек-листы для каждого типа!
В прошлом году я провафлила этот момент, теперь исправляюсь. Итоги 12 недель были, пора и итоги года подвести! Хотя по сути это будет агрегация моих постов про 12 недель, но ведь надо же посмотреть, сколько всего я успела! =))
Мои прошлые итоги: 2016, 2017, 2018, 2019, 2020, 2021, 2022.
Ох, какой выдался год:
- Я родила второго сыночка, Лешу!
- Забеременела третьим и прошла через пару месяцев токсикоза и апатии...
- Выпустила третью книгу! В конце 2023 года я сдала её, но пока верстали и прочее... Вышла уже в 2024 =)
- Написала четвертую книгу, почти всю — я её в эти новогодние праздники доделала, скоро сдам.
- Получила лицензию на ИП, переделала внешний вид сертификатов, а то жаловались, что "детские" слишком, там рисунок с девочкой раньше был. Теперь всё серьезно!
- Запустила 3 (!!!) новых курса!
Первый опыт, второй, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15,
16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28
Вы собираетесь с друзьями в группу и ставите себе цели на 12 недель (3 месяца). Это могут быть как рабочие, так и личные задачи. Такие, которые вы вроде как хотите сделать, но вечно откладываете, так как «некогда, потом, щас, вот только мелочевку разгребу и тот пожарчик потушу».
Настало время заняться тем, чем действительно хочется! Отталкиваясь от глобальных целей, составляете план на неделю. И раз в неделю встречаетесь с группой и обсуждаете, сколько успели, сколько нет. Какой план на следующую неделю. Я, правда, уже давно не встречаюсь, а просто веду файлик "что сделано", откуда потом и просматриваю всё, что успела за цикл.
Основной план был:
- закончить книгу по SQL
- переписать автоматизацию в постмане
- 1 статья на Хабр
А в итоге я прошла через торг, депрессию череду болезней — почти весь ноябрь была слабость и апатия. Да и впервые Новый год я встречала в больничке 😕 Плюс этот цикл пришелся на праздники — день рождения, Новый год... Ну и, конечно же, подрастающий ребенок требует всё больше времени...
Однако! Я даже статью на Хабр выпустила, ура-ура. Буквально на следующий день после подведения итогов и больше их не было, но не будем о грустном, цель то достигнута!
Книгу я честно пыталась закончить и даже вышла на мощный режим написания глав. Особенно ускорилась в новом 2025 году, по паре глав в день сейчас пишу =)) Не закончила, но очень близка к этому!
А вот курс только начала переписывать, но об этом чуть позже. Что в итоге сделала:
