Инструменты · key

`speedtest` Скорость загрузки страницы, размер, код ответа и IP сервера

Загружает страницу и отдаёт выбранные замеры: время отклика сервера, время загрузки HTML-кода, размер страницы, код ответа и IP-адрес сервера, с предупреждениями при превышении рекомендованных значений. Метод синхронный. Веб-версия — инструмент «Проверка скорости загрузки».

Режим: синхронный
URL за вызов: 1
Стоимость: лимиты не списываются, но на балансе должен быть хотя бы 1 лимит

Замер страницы

GET /api/speedtest

Замеры включаются флагами cb_*; без флагов в ответе будут только адреса. Страница загружается с таймаутом 10 секунд, по редиректам — до конечного адреса. Параметры можно передать и в query-строке, и в теле POST.

Параметры query

key string обязательный

Ключ API из настроек аккаунта.
url string обязательный

Адрес страницы. Без протокола подставляется http://; кириллический домен допустим.
cb_response_time bool

Время отклика сервера, мс — до первого байта ответа (TTFB). Включается любым непустым значением, например on.
cb_upload_time bool

Время полной загрузки HTML-кода, мс. Включается любым непустым значением, например on.
cb_page_size bool

Размер HTML-кода, КБ. Включается любым непустым значением, например on.
cb_server_response bool

HTTP-код ответа. Включается любым непустым значением, например on.
cb_ip bool

IP-адреса сервера (A-записи домена). Включается любым непустым значением, например on.

Ответ

Замеры сгруппированы по показателю, внутри — по URL в том виде, в каком он передан.

urls array

Проверенные URL.
incorrect_urls array

URL, которые не удалось проверить: не похожи на адрес или сервер ответил 502. Замеров по ним нет.
url_with_http object

URL → конечный адрес после редиректов.
connect_time object

cb_response_time: URL → время отклика, мс.
total_time object

cb_upload_time: URL → время загрузки кода, мс.
size_download object

cb_page_size: URL → размер, КБ, с точностью 0,1.
http_code object

cb_server_response: URL → код ответа.
primary_ip object

cb_ip: URL → массив IP-адресов.
warning object

URL → список предупреждений; ["Нет"], если их нет.
warning_connect_time, warning_total_time, warning_size_download, warning_http_code array

Только при превышении: URL, у которых сработало соответствующее предупреждение.

GET /api/speedtest

curl -G 'https://tools.pixelplus.ru/api/speedtest' \
  --data-urlencode 'key=ВАШ_КЛЮЧ' \
  --data-urlencode 'url=https://pixelplus.ru/' \
  --data-urlencode 'cb_response_time=on' \
  --data-urlencode 'cb_upload_time=on' \
  --data-urlencode 'cb_page_size=on' \
  --data-urlencode 'cb_server_response=on'

<?php
$url = 'https://tools.pixelplus.ru/api/speedtest?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
    'url' => 'https://pixelplus.ru/',
    'cb_response_time' => 'on',
    'cb_upload_time' => 'on',
    'cb_page_size' => 'on',
    'cb_server_response' => 'on',
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.get(
    "https://tools.pixelplus.ru/api/speedtest",
    params={
        "key": "ВАШ_КЛЮЧ",
        "url": "https://pixelplus.ru/",
        "cb_response_time": "on",
        "cb_upload_time": "on",
        "cb_page_size": "on",
        "cb_server_response": "on",
    },
    timeout=60,
)
print(response.json())

url обязательный Адрес страницы cb_response_time Время отклика сервера, мс — до первого байта ответа (TTFB) cb_upload_time Время полной загрузки HTML-кода, мс cb_page_size Размер HTML-кода, КБ cb_server_response HTTP-код ответа

Запрос настоящий — выполнится с вашим ключом

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

{
    "urls": [
        "https://pixelplus.ru/"
    ],
    "incorrect_urls": [],
    "url_with_http": {
        "https://pixelplus.ru/": "https://pixelplus.ru/"
    },
    "connect_time": {
        "https://pixelplus.ru/": "184"
    },
    "size_download": {
        "https://pixelplus.ru/": 142.6
    },
    "warning": {
        "https://pixelplus.ru/": [
            "Размер кода документа превышает максимально рекомендованное значение в 120 КБ."
        ]
    },
    "warning_size_download": [
        "https://pixelplus.ru/"
    ],
    "total_time": {
        "https://pixelplus.ru/": "412"
    },
    "http_code": {
        "https://pixelplus.ru/": 200
    }
}

Ошибки

Код	Сообщение	Когда
`-50`	`Not set`	Не передан `url`. Код приходит строкой.
`-68, -80…-83`	`Not enough … limits`	На балансе нет ни одного лимита.
`-1, -2`	`Access denied`	Ключ не передан (HTTP 404) или не найден (HTTP 403).

Ответ с ошибкой

{
    "url": "Not set",
    "code": "-50"
}

Пороги предупреждений

Показатель	Предупреждение, если
Время отклика	установка соединения дольше 200 мс
Время загрузки кода	больше 700 мс
Размер страницы	больше 120 КБ
Код ответа	не 200

Если страница не загрузилась (таймаут, ошибка соединения), вместо значений приходит -. Размер — это HTML-код без картинок, стилей и скриптов; время — загрузка этого кода, а не отрисовка страницы.