Softonic

Проверка API-эндпоинта

Шаг 1 / 2
Необязательные условия для ответа

Оставьте любое поле пустым, чтобы пропустить проверку. Скрытый заголовок или нечитаемое тело означают, что результат недоступен, а не что условие не выполнено.

CORS определяет, какие ответы и заголовки может прочитать эта страница. Целевой сервер получает запрос и ваш IP-адрес.

Далее
Статус
Продолжительность
ms
Байты
Конечный URL после перенаправления:
Предпросмотр ограничен 1 МиБ. Возможно, конечная точка вернула больше данных.

Проверки ответа

Отчёт об одном запросе без содержимого запроса и ответа

Файл содержит метод, адрес эндпоинта до уровня origin, итоговый статус, время и результаты проверок. Путь и параметры URL, заголовки и тело запроса, тело и значения заголовков ответа не включаются.

Отправьте из браузера запрос GET, HEAD, POST, PUT, PATCH или DELETE и изучите конечный ответ. При необходимости проверьте код состояния или диапазон, доступный заголовок ответа и свойство JSON. Для каждого заданного условия отображается результат: Выполнено, Не выполнено или Нет данных. Инструмент показывает итоговый статус, время до получения заголовков, видимые браузеру заголовки и до 1 MiB текста ответа. Запрос отправляется только после нажатия кнопки «Отправить запрос».

Как проверить API-эндпоинт

  1. 1

    Укажите запрос

    Введите URL с HTTP или HTTPS и выберите метод. Если эндпоинту нужны заголовки запроса или тело, добавьте их. Методы GET и HEAD не отправляют введённое тело.

  2. 2

    Задайте необязательные условия

    Используйте код, например 200, диапазон 200-204 или группу 2xx. Также можно указать заголовок ответа и путь JSON, при необходимости с ожидаемым значением для каждого. Чтобы пропустить проверку, оставьте поле пустым.

  3. 3

    Отправьте запрос и изучите результат

    Один раз нажмите «Отправить запрос». Посмотрите итоговый статус и результат каждого условия. Скрытый заголовок, нечитаемый ответ или неполное тело JSON могут привести к результату «Нет данных».

  4. 4

    Сохраните отчёт без содержимого запроса и ответа

    Скачайте текстовый отчёт или JSON для этой проверки. В нём указаны origin эндпоинта, метод, итоговый статус, время и результаты, но нет пути и параметров URL, значений запроса и содержимого ответа.

Пример проверки ответа

Допустим, ваш эндпоинт GET https://api.example.com/health возвращает статус 200, доступный заголовок Content-Type: application/json и {"status":"ready"}. Можно указать:

Необязательное поле Пример Что проверяется
Ожидаемые коды состояния 200, 204 или 2xx Входит ли итоговый статус в выбранный набор.
Имя заголовка ответа Content-Type Доступен ли этот заголовок браузеру.
Ожидаемое значение заголовка application/json Совпадает ли доступное значение в точности. Оставьте поле пустым, чтобы проверить только доступность.
Путь к свойству JSON $.status Есть ли это свойство в полном ответе JSON.
Ожидаемое значение JSON "ready" Совпадает ли прочитанное значение JSON. Оставьте поле пустым, чтобы проверить только наличие свойства.

Поле значения JSON принимает синтаксис JSON: true для логического значения, 42 для числа и "ready" для строки. Пути начинаются с $ и поддерживают свойства и индексы массивов, например $.data.items[0].id. Они не выполняют скрипты и не поддерживают фильтры. Если свойство отсутствует в читаемом JSON, условие считается невыполненным. Если заголовка нет или он скрыт правилами CORS, результат будет Нет данных, поскольку браузер не может различить эти случаи.

Что означает результат

Результат Значение
Выполнено Доступный для чтения конечный ответ соответствует этому условию.
Не выполнено Доступный для чтения конечный ответ не соответствует условию или в нём нет запрошенного свойства JSON.
Нет данных Браузер не может определить результат: например, ответ недоступен для чтения, заголовок отсутствует или скрыт, либо тело JSON пустое, неполное или некорректное.

Таймер останавливается при получении заголовков ответа. Он не измеряет загрузку тела целиком. Запрос прерывается через 15 секунд; размер тела запроса ограничен 1 MiB, а предпросмотр ответа обрывается после 1 MiB. По обрезанному ответу нельзя проверить свойство JSON. У ответов HEAD и 204 нет тела для проверки, поэтому результат проверки JSON будет «Нет данных». Инструмент следует редиректам и сообщает конечный URL, но не показывает каждый переход и не повторяет запрос автоматически. Правила CORS могут помешать браузеру прочитать ответ, даже если эндпоинт получил запрос. Перед запросом выбранным методом браузер также может отправить предварительный запрос CORS.

Можно проверить только те заголовки ответа, которые доступны браузеру. Чтобы открыть доступ к пользовательскому заголовку, серверу может потребоваться перечислить его в Access-Control-Expose-Headers. Если заголовок не виден на этой странице, он либо отсутствует на сервере, либо скрыт правилами CORS. Различить эти случаи помогут журналы сервера или подходящий клиент API.

Часто задаваемые вопросы

«Не выполнено» означает, что доступный браузеру ответ противоречит ожидаемому результату. «Нет данных» означает, что браузер не может установить результат. Например, он не различает отсутствующий заголовок и заголовок, скрытый правилами CORS, и не может проверить JSON в пустом, нечитаемом или обрезанном теле.

Можно указать заголовок Authorization, если эндпоинт разрешает такой браузерный запрос через CORS. Инструмент не добавляет cookies браузера или другие автоматически передаваемые учётные данные. Значение заголовка отправляется непосредственно на целевой сервер, поэтому используйте учётные данные только с доверенным эндпоинтом.

Браузер отправляет запрос прямо на целевой сервер, который получает запрос и ваш IP-адрес. Указанные URL, заголовки и тело запроса не проходят через серверы этого сайта и не попадают в URL страницы инструмента. В отчёте с удалёнными данными сохраняется начало адреса конечной точки (протокол, домен и порт), но опускаются остальная часть URL, заголовки и тело запроса. Для перехода между шагами инструмент ненадолго сохраняет введённые данные в хранилище сеанса этой вкладки. Запись принимается не более пяти минут и удаляется при чтении, при запуске заново или после проверки. Пока запись существует, её могут прочитать скрипты этого же сайта. Если браузер блокирует хранилище, запрос можно отправить с той же страницы.

Для текущей проверки создаётся один текстовый отчёт или отчёт JSON. Он содержит origin эндпоинта, метод, итоговый статус, время до получения заголовков ответа, количество сохранённых байтов, признаки редиректа и обрезки, а также результаты проверок. Путь, параметры и фрагмент URL, заголовки запроса и их значения, тело запроса, заголовки ответа и их значения, а также тело ответа исключены. Проверьте файл перед отправкой другим людям: origin и результаты всё ещё могут раскрывать ваш сервис.

Таймер запускается непосредственно перед началом Fetch в браузере и останавливается при получении заголовков конечного ответа. Он учитывает затраты браузера и сети, а также разрешённые редиректы, но не чтение тела. Серверные журналы могут измерять другой интервал.

Нет. Проверка запускается по нажатию кнопки «Отправить запрос». Инструмент не планирует запросы, не повторяет их автоматически и не ведёт мониторинг. Предварительные запросы CORS и редиректы всё же могут добавить сетевые запросы к одной проверке.

Сопутствующие инструменты

Проверка SSL-сертификата

Проверьте сертификат SSL/TLS, который узел отдаёт на порту 443: субъект, издатель, даты действия, дни до истечения, SAN и алгоритм подписи.

Проверка HTTP-заголовков

Осмотрите каждый HTTP-заголовок ответа, возвращаемый URL, чтобы отладить кэширование, CORS, сжатие и проблемы безопасности.

Инструмент проверки возраста доменных имен

Узнайте, когда домен был впервые зарегистрирован, а также его возраст в годах, месяцах и днях с использованием данных WHOIS из реестра.

Инструмент Traceroute

Запустите traceroute до любого хоста через проверенные публичные сервисы зондирования и научитесь читать вывод хоп за хопом, чтобы находить скачки задержки, потери пакетов и проблемы маршрутизации.

Инструмент для скриншотов сайтов

Введите любой публичный URL и получите мгновенный предпросмотр скриншота, затем откройте его в бесплатных сервисах вроде Screenshot Machine, Urlbox или ApiFlash либо посмотрите старые снимки на Wayback Machine.

Проверка доступности сайта

Проверьте, отвечает ли сайт с независимого сервера. Показывает статус UP или DOWN, код ответа HTTP, время ответа и IP сервера, чтобы вы могли отличить реальный сбой от проблемы вашей сети.

Инструмент доступен на других языках