EN

4. API

Задание

Чтобы начать практические задания по API, вам сначала необходимо настроить окружение. Это включает в себя загрузку и установку Postman — популярного и удобного инструмента для отправки и тестирования API-запросов. После установки убедитесь, что сервер работает и вы можете успешно получать от него ответы.

Пожалуйста, следуйте приведенным ниже инструкциям по установке Postman и проверьте доступность API. Используйте предоставленный базовый URL, чтобы отправить простой запрос и убедиться, что получаете ответ со статус-кодом 200, что указывает на корректную работу всех компонентов.

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

Инструкция

  1. Перейдите на официальный сайт Postman https://www.postman.com/downloads/.
    Это официальный источник, откуда можно безопасно скачать Postman.
  2. Скачайте и установите Postman. Выберите установщик, соответствующий вашей операционной системе (Windows, macOS или Linux), и загрузите его. После завершения загрузки запустите установщик и следуйте инструкциям по настройке на экране.
  3. Создайте учетную запись Postman. После установки откройте Postman и зарегистрируйте бесплатную учетную запись. Наличие учетной записи позволяет сохранять ваши коллекции, запросы и настройки рабочего пространства — что значительно упрощает работу.
  4. Перейдите по ссылке https://realbugz-api.onrender.com/docs.
    Этот API размещен на бесплатном сервере, который автоматически переходит в спящий режим при отсутствии активных запросов. Поэтому вам, скорее всего, потребуется немного подождать, пока он запустится. Обычно загрузка страницы занимает не более 1–2 минут.
    Пока сервер загружается, вы будете видеть следующую страницу: Loading Eldoria API documentation screen Когда все будет готово, вы увидите документацию Swagger: Eldoria API documentation
  5. Используя базовый URL https://realbugz-api.onrender.com/, отправьте простой GET запрос.
    Вы должны получить следующий ответ со статус-кодом 200: Eldoria API documentation
  6. Всё готово! После завершения настройки изучите документацию API, нажмите на кнопку 'Вперёд!' ниже и попробуйте отправить API-запросы, описанные в задании.

Важно:

Если вы не видите страницу, показанную на шаге 4 инструкции выше, попробуйте подождать 5–7 минут. Обычно сервис запускается быстро, но так как он размещен на бесплатном сервере, время запуска иногда может занять немного больше времени. 🤷‍♂️

Решения всех заданий содержатся в файле коллекции на странице задания. Мы рекомендуем вам сначала попытаться отправить API-запросы самостоятельно. Обращайтесь к предоставленным ответам только в том случае, если не можете продвинуться в течение 15-20 минут.

Некоторые из доступных в этом задании эндпоинтов API включают публичные методы удаления. Пожалуйста, создавайте, используйте и удаляйте только те данные, которые вы лично создали. Не вмешивайтесь в работу других пользователей и не удаляйте данные, которые вы не создавали.

Спасибо, что проявляете уважение и помогаете поддерживать стабильность обучающей платформы для всех! 🙏