Результаты Проверок

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

Получить Результаты Проверки

GET /v1/checks/{check_id}/results

Параметры запроса (для пагинации):

Вы можете управлять выводом данных, используя следующие параметры запроса:

• page_size: Определяет количество элементов, возвращаемых на одной странице. Максимальное значение — 100. По умолчанию — 20.
• page: Задает номер запрашиваемой страницы. По умолчанию — 1.

Объект

Ответ на запрос GET /v1/checks/{check_id}/results содержит объект пагинации и массив results, где каждый элемент — это отдельный результат выполнения проверки.

{
	"pagination": {
		"page": 1,
		"page_size": 20,
		"total_items": 245,
		"total_pages": 13
	},
	"results": [
		{
			"check_id": "tnfk22p4vqvh",
			"check_metadata": {
				"connected": true,
				"host": "pingera.ru",
				"port": 443
			},
			"check_server": {
				"country": "US",
				"id": "1d681l48qwv1",
				"ip_address": "34.82.58.13",
				"region": "East coast",
				"server_metadata": {
					"provider": "AWS"
				}
			},
			"check_server_id": "1d681l48qwv1",
			"created_at": "2025-05-25T12:01:39.877256",
			"error_message": null,
			"id": "qb3ezm6752td",
			"response_time": 20194,
			"status": "ok"
		}
	]
}

Поля

Поле	Тип объекта	Описание
pagination	object	Объект пагинации, содержащий page, page_size, total_items, total_pages.
results	array	Массив объектов результатов проверки.

Массив results

Каждый элемент в массиве results представляет собой отдельный результат мониторинга.

Поле	Тип объекта	Описание
id	string	Уникальный идентификатор конкретного результата проверки.
check_id	string	ID регулярной проверки, к которой относится данный результат.
created_at	string (ISO 8601)	Дата и время записи результата.
status	string	Статус выполнения проверки: ok, down, failed.
response_time	number or null	Время ответа в миллисекундах. null, если не применимо (например, для SSL-проверок без сетевого соединения).
error_message	string or null	Сообщение об ошибке, если проверка завершилась неуспешно.
check_server_id	string	ID сервера, с которого была выполнена проверка.
check_server	object	Детали о сервере, выполнившем проверку (см. ниже).
check_metadata	object	Дополнительные метаданные, специфичные для типа проверки (см. ниже).

Объект check_server

Содержит информацию о сервере, который выполнил проверку.

Поле	Тип объекта	Описание
id	string	ID сервера проверки.
country	string	Страна расположения сервера (ISO 3166-1 alpha-2 код).
region	string	Регион расположения сервера.
ip_address	string	IP-адрес сервера проверки.
server_metadata	object	Дополнительные метаданные о сервере, например, провайдер.

"check_server": {
    "country": "US",
    "id": "1d681l48qwv1",
    "ip_address": "34.82.58.13",
    "region": "East coast",
    "server_metadata": {
        "provider": "AWS"
    }
}

Объект check_metadata

Содержание поля check_metadata зависит от типа (type) исходной Проверки.

Для type: "web", type: "api" и type: "tcp"

Поле	Тип объекта	Описание
connected	boolean	Указывает, было ли установлено соединение.
host	string	Хост, который был проверен.
port	number	Порт, который был проверен.
status_code	number	(Только для web, api) HTTP статус-код ответа.
headers	object	(Только для web, api) HTTP заголовки ответа.

"check_metadata": {
    "connected": true,
    "host": "pingera.ru",
    "port": 443,
    // Для "web" и "api" также могут быть:
    // "status_code": 200,
    // "headers": { ... }
}

Для type: "ssl"

Для SSL-проверок check_metadata содержит детализированную информацию о SSL-сертификате, его цепочке, поддерживаемых протоколах и известных уязвимостях. Поле check_metadata динамично для SSL проверок динамично, т.к. мы постоянно добавляем информацию о новых уязвимостях и слабых шифрах.

{
	"check_metadata": {
		"assertion_failed": true,
		"checks": {
			"certificate_info": {
				"cert_date_valid": true,
				"hostname_mismatch": false,
				"in_trust_store": true,
				"is_ev_cert": false,
				"is_revoked": null,
				"issuer": "CN=GlobalSign GCC R6 AlphaSSL CA 2023,O=GlobalSign nv-sa,C=BE",
				"key_size": 2048,
				"not_after": "2025-07-20T09:00:44+00:00",
				"not_before": "2024-06-18T09:00:45+00:00",
				"ocsp_stapling_details": "No OCSP stapled response provided by server.",
				"serial_number": "0x72080fa3d691b1c2c5f60e87",
				"signature_algorithm": "sha256",
				"subject": "CN=*.pingera.ru"
			},
			"has_weak_ciphers": false,
			"protocol_support": {
				"ssl_2_0": {
					"ciphers": [],
					"supported": false
				},
				"ssl_3_0": {
					"ciphers": [],
					"supported": false
				},
				"tls_1_0": {
					"ciphers": [],
					"supported": false
				},
				"tls_1_1": {
					"ciphers": [],
					"supported": false
				},
				"tls_1_2": {
					"ciphers": [
						"TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256",
						"TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384",
						"TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256"
					],
					"supported": true
				},
				"tls_1_3": {
					"ciphers": [
						"TLS_CHACHA20_POLY1305_SHA256",
						"TLS_AES_256_GCM_SHA384",
						"TLS_AES_128_GCM_SHA256"
					],
					"supported": true
				}
			},
			"vulnerabilities": {
				"ccs_injection": {
					"details": "Not vulnerable",
					"vulnerable": false
				},
				"heartbleed": {
					"details": "Not vulnerable",
					"vulnerable": false
				},
				"robot": {
					"details": "NOT_VULNERABLE_RSA_NOT_SUPPORTED",
					"vulnerable": false
				},
				"session_renegotiation": {
					"details": "Secure renegotiation (RFC 5746) is supported. Server does not appear to accept client-initiated renegotiation (client_renegotiations_success_count is 0).",
					"vulnerable": false
				}
			},
			"weak_ciphers_found_details": []
		},
		"deduction_summary": [
			"Excellent configuration or only minor issues not penalized."
		],
		"ssl_grade": "A+",
		"ssl_score": 100
	}
}

Для type: "synthetic" до 09 июля 2025 года.

warning

Этот формат ответа больше не используется. API будет возвращать результаты в этом формате для проверок, которые были созданы до 9 июля 2025 года. Актуальный формат ответа смотрите ниже.

Для Синтетических проверок мы возвращаем следующий ответ:

"result": {
  "check_metadata": {
    "function_execution_time": 4725,
    "headers": {
      "accept-ranges": "bytes",
      "content-encoding": "gzip",
      "content-length": "11264",
      "content-type": "text/html; charset=UTF-8",
      "date": "Fri, 13 Jun 2025 09:42:23 GMT",
      "server": "ddos-guard",
      "x-frame-options": "SAMEORIGIN"
    },
    "navigation_timing": {
      "dns_lookup": 12.3,
      "dom_content_loaded": 17.2,
      "load_complete": 9.3,
      "request_start": 0.2,
      "response_end": 8.2,
      "response_start": 11.6,
      "ssl_handshake": 27,
      "tcp_connect": 35.1,
      "total_time": 562
    },
    "resource_timings": [
      {
        "duration": 51,
        "resource_type": "script",
        "size": 0,
        "start_time": 84.3,
        "status": 200,
        "url": "https://some.url.com/js/fallback-1.0.min.js"
      }
      // ... (остальные ресурсы)
    ],
    "screenshot_path": "Ссылка на скриншот",
    "status_code": 200,
    "total_resources": 39
  },
  "check_server": {
    "country": "RU",
    "id": "rt19v2tvydu8",
    "ip_address": "31.44.8.123",
    "region": "Moscow",
    "server_metadata": {
      "provider": "Yandex"
    }
  },
  "error_message": null,
  "response_time": 1547,
  "status": "ok"
}

Поле	Тип	Описание
check_metadata	Объект	Содержит подробные метаданные о выполненной проверке.
check_metadata.function_execution_time	Число	Время выполнения функции проверки в миллисекундах.
check_metadata.headers	Объект	Заголовки HTTP-ответа, полученные от сервера.
check_metadata.navigation_timing	Объект	Детальные метрики производительности загрузки страницы, включая:
dns_lookup	Число	Время разрешения DNS-имени в мс.
dom_content_loaded	Число	Время до загрузки и парсинга DOM-дерева в мс.
load_complete	Число	Общее время загрузки страницы (со всеми ресурсами) в мс.
request_start	Число	Время начала запроса в мс.
response_end	Число	Время окончания получения ответа в мс.
response_start	Число	Время начала получения ответа в мс.
ssl_handshake	Число	Время на SSL/TLS рукопожатие в мс.
tcp_connect	Число	Время на установление TCP-соединения в мс.
total_time	Число	Общее время навигации в мс.
check_metadata.resource_timings	Массив объектов	Список загруженных ресурсов (скрипты, стили, изображения) и метрики по каждому из них.
duration	Число	Время загрузки ресурса в мс.
resource_type	Строка	Тип ресурса (например, "script", "stylesheet", "image", "font").
size	Число	Размер ресурса в байтах (может быть 0 для некоторых типов).
start_time	Число	Время начала загрузки ресурса относительно начала навигации в мс.
status	Число	HTTP-статус код ответа для ресурса.
url	Строка	URL загруженного ресурса.
check_metadata.screenshot_path	Строка	URL к сделанному скриншоту страницы (если опция включена).
check_metadata.status_code	Число	HTTP-статус код основного ответа страницы.
check_metadata.total_resources	Число	Общее количество загруженных ресурсов на странице.
check_server	Объект	Информация о сервере, с которого производилась проверка.
check_server.country	Строка	Код страны сервера проверки (например, "RU").
check_server.id	Строка	Уникальный идентификатор сервера проверки.
check_server.ip_address	Строка	IP-адрес сервера проверки.
check_server.region	Строка	Регион размещения сервера проверки (например, "Moscow").
check_server.server_metadata	Объект	Дополнительные метаданные о сервере.
provider	Строка	Провайдер сервера (например, "Yandex").
error_message	Строка / null	Сообщение об ошибке, если проверка завершилась неудачно. Будет null, если ошибок нет.
response_time	Число	Общее время ответа от сервера в миллисекундах.
status	Строка	Общий статус проверки ("ok" или "error").

Для type: "synthetic" после 09 июля 2025 года

Все Синтетические проверки начиная с 9 июля 2025 года возвращают результат в новом формате:

{
  "results": [
    {
      "check_id": "masked_check_id",
      "check_metadata": {
        "execution_time": 7627,
        "logs": [
          {
            "level": "log",
            "message": "Успешно загрузили страницу и сделали скриншот",
            "timestamp": "YYYY-MM-DDTHH:MM:SS.SSSZ"
          }
        ],
        "pages": [
          {
            "documentRequest": {
              "method": "GET",
              "requestHeaders": { /* ... */ },
              "responseHeaders": { /* ... */ },
              "statusCode": 200,
              "timing": {
                "connectEnd": 31.5,
                "connectStart": 2.6,
                "domainLookupEnd": 2.6,
                "domainLookupStart": 0.9,
                "requestStart": 31.6,
                "responseEnd": 47.8,
                "responseStart": 39.5,
                "secureConnectionStart": 6.2,
                "startTime": 0
              },
              "url": "https://example.com/"
            },
            "duration": 518.1,
            "network": [
              {
                "method": "GET",
                "requestHeaders": { /* ... */ },
                "resourceType": "navigation",
                "responseHeaders": { /* ... */ },
                "statusCode": 200,
                "time": 518.1,
                "url": "https://example.com/"
              },
              {
                "method": "GET",
                "requestHeaders": { /* ... */ },
                "resourceType": "script",
                "responseHeaders": { /* ... */ },
                "statusCode": 200,
                "time": 29.8,
                "url": "https://static.example.com/js/script.min.js"
              }
              // ... (остальные ресурсы)
            ],
            "networkSummary": {
              "count": 38,
              "truncated": false
            },
            "url": "https://example.com/",
            "webVitals": {
              "FCP": 1012,
              "LCP": 97.3,
              "TTFB": 7.9
            }
          }
        ],
        "response_version": "2",
        "test_results": [
          {
            "browser_metadata": {
              "browser": "chromium",
              "screenshots": [
                {
                  "contentType": "image/jpeg",
                  "name": "screenshot.jpg",
                  "url": "https://storage.example.com/screenshots/screenshot.jpg"
                }
              ],
              "videos": []
            },
            "duration": 2494,
            "error": null,
            "name": "Basic Screenshot",
            "status": "passed",
            "steps": []
          }
        ],
        "test_summary": {
          "failed": 0,
          "passed": 1,
          "total": 1
        }
      },
      "check_server": {
        "country": "RU",
        "id": "masked_server_id",
        "ip_address": "masked_ip_address",
        "region": "Moscow",
        "server_metadata": {
          "provider": "Yandex"
        }
      },
      "check_server_id": "masked_server_id",
      "created_at": "YYYY-MM-DDTHH:MM:SS.SSSSSS",
      "error_message": null,
      "id": "masked_result_id",
      "response_time": 2494,
      "status": "ok"
    }
  ]
}

"response_version": "2" - указывает на новый формат.

Поле	Тип	Описание
results	Массив объектов	Массив результатов для каждой выполненной проверки.
results.check_id	Строка	Уникальный идентификатор проверки.
results.check_metadata	Объект	Содержит подробные метаданные о выполненной проверке.
results.check_metadata.execution_time	Число	Время выполнения функции проверки в миллисекундах.
results.check_metadata.logs	Массив объектов	Логи, сгенерированные во время выполнения проверки.
results.check_metadata.logs.level	Строка	Уровень лога (например, "log", "info", "error").
results.check_metadata.logs.message	Строка	Сообщение лога.
results.check_metadata.logs.timestamp	Строка	Время создания лога в формате ISO 8601.
results.check_metadata.pages	Массив объектов	Список страниц, посещенных во время проверки.
results.check_metadata.pages.documentRequest	Объект	Информация о запросе основного документа страницы.
results.check_metadata.pages.documentRequest.method	Строка	HTTP-метод запроса (например, "GET", "POST").
results.check_metadata.pages.documentRequest.requestHeaders	Объект	Заголовки HTTP-запроса.
results.check_metadata.pages.documentRequest.responseHeaders	Объект	Заголовки HTTP-ответа.
results.check_metadata.pages.documentRequest.statusCode	Число	HTTP-статус код ответа для основного документа.
results.check_metadata.pages.documentRequest.timing	Объект	Детальные метрики производительности загрузки основного документа, включая:
connectEnd	Число	Время окончания установки соединения в мс.
connectStart	Число	Время начала установки соединения в мс.
domainLookupEnd	Число	Время окончания разрешения DNS в мс.
domainLookupStart	Число	Время начала разрешения DNS в мс.
requestStart	Число	Время начала запроса в мс.
responseEnd	Число	Время окончания получения ответа в мс.
responseStart	Число	Время начала получения ответа в мс.
secureConnectionStart	Число	Время начала SSL/TLS соединения в мс.
startTime	Число	Время начала навигации в мс.
results.check_metadata.pages.documentRequest.url	Строка	URL основного документа.
results.check_metadata.pages.duration	Число	Общее время загрузки страницы в мс.
results.check_metadata.pages.network	Массив объектов	Список сетевых запросов, сделанных на странице.
results.check_metadata.pages.network.method	Строка	HTTP-метод запроса.
results.check_metadata.pages.network.requestHeaders	Объект	Заголовки HTTP-запроса для ресурса.
results.check_metadata.pages.network.resourceType	Строка	Тип ресурса (например, "navigation", "script", "img", "link").
results.check_metadata.pages.network.responseHeaders	Объект	Заголовки HTTP-ответа для ресурса.
results.check_metadata.pages.network.statusCode	Число	HTTP-статус код ответа для ресурса.
results.check_metadata.pages.network.time	Число	Время загрузки ресурса в мс.
results.check_metadata.pages.network.url	Строка	URL загруженного ресурса.
results.check_metadata.pages.networkSummary	Объект	Краткая сводка по сетевым запросам.
results.check_metadata.pages.networkSummary.count	Число	Общее количество сетевых запросов.
results.check_metadata.pages.networkSummary.truncated	Булево	Указывает, был ли список сетевых запросов усечен. Мы подгружаем не более 50 сетевых запросов в ответ.
results.check_metadata.pages.url	Строка	URL страницы.
results.check_metadata.pages.webVitals	Объект	Метрики Web Vitals для страницы.
results.check_metadata.pages.webVitals.FCP	Число	First Contentful Paint в мс.
results.check_metadata.pages.webVitals.LCP	Число	Largest Contentful Paint в мс.
results.check_metadata.pages.webVitals.TTFB	Число	Time To First Byte в мс.
results.check_metadata.response_version	Строка	Версия формата ответа.
results.check_metadata.test_results	Массив объектов	Результаты выполнения отдельных тестовых шагов.
results.check_metadata.test_results.browser_metadata	Объект	Метаданные о браузере, использованном для проверки.
results.check_metadata.test_results.browser_metadata.browser	Строка	Используемый браузер (например, "chromium").
results.check_metadata.test_results.browser_metadata.screenshots	Массив объектов	Список сделанных скриншотов.
results.check_metadata.test_results.browser_metadata.screenshots.contentType	Строка	Тип контента скриншота (например, "image/jpeg").
results.check_metadata.test_results.browser_metadata.screenshots.name	Строка	Имя файла скриншота.
results.check_metadata.test_results.browser_metadata.screenshots.url	Строка	URL к сделанному скриншоту.
results.check_metadata.test_results.browser_metadata.videos	Массив	Список сделанных видео (если опция включена).
results.check_metadata.test_results.duration	Число	Продолжительность выполнения тестового шага в мс.
results.check_metadata.test_results.error	Строка / null	Сообщение об ошибке для этого шага, если есть.
results.check_metadata.test_results.name	Строка	Название тестового шага.
results.check_metadata.test_results.status	Строка	Статус выполнения тестового шага ("passed", "failed").
results.check_metadata.test_results.steps	Массив	Вложенные шаги (если применимо).
results.check_metadata.test_summary	Объект	Краткая сводка по тестовым шагам.
results.check_metadata.test_summary.failed	Число	Количество проваленных шагов.
results.check_metadata.test_summary.passed	Число	Количество успешно пройденных шагов.
results.check_metadata.test_summary.total	Число	Общее количество тестовых шагов.
results.check_server	Объект	Информация о сервере, с которого производилась проверка.
results.check_server.country	Строка	Код страны сервера проверки (например, "RU").
results.check_server.id	Строка	Уникальный идентификатор сервера проверки.
results.check_server.ip_address	Строка	IP-адрес сервера проверки.
results.check_server.region	Строка	Регион размещения сервера проверки (например, "Moscow").
results.check_server.server_metadata	Объект	Дополнительные метаданные о сервере.
results.check_server.server_metadata.provider	Строка	Провайдер сервера (например, "Yandex").
results.check_server_id	Строка	Идентификатор сервера проверки.
results.created_at	Строка	Время создания записи о проверке в формате ISO 8601.
results.error_message	Строка / null	Сообщение об ошибке, если проверка завершилась неудачно. Будет null, если ошибок нет.
results.id	Строка	Уникальный идентификатор результата проверки.
results.response_time	Число	Общее время выполнения тестов.
results.status	Строка	Общий статус проверки ("ok" или "error").

Для type: "multistep"

Для пошаговых проверок API мы возвращаем следующий ответ:

{
  "pagination": {
    "page": 1,
    "page_size": 20,
    "total_items": 2,
    "total_pages": 1
  },
  "results": [
    {
      "check_id": "example_check_id",
      "check_metadata": {
        "execution_time": 1234,
        "logs": [
          {
            "level": "log",
            "message": "Отправка запроса на: https://api.example.com/v1/resource/",
            "timestamp": "2025-07-02T12:00:00.000Z"
          },
          {
            "level": "info",
            "message": "Успешно получен ответ со статусом: 200",
            "timestamp": "2025-07-02T12:00:00.100Z"
          },
          {
            "level": "warn",
            "message": "Несоответствие количества элементов: ожидалось 10, получено 9",
            "timestamp": "2025-07-02T12:00:00.200Z"
          }
        ],
        "test_results": [
          {
            "duration": 567,
            "error": null,
            "name": "Поток аутентификации пользователя",
            "softAssertionErrors": 0,
            "status": "passed",
            "steps": [
              {
                "duration": 150,
                "error": null,
                "name": "Вход с учетными данными",
                "status": "passed"
              },
              {
                "duration": 200,
                "error": null,
                "name": "Получение профиля пользователя",
                "status": "passed"
              },
              {
                "duration": 100,
                "error": null,
                "name": "Обновление электронной почты пользователя",
                "status": "passed"
              }
            ]
          },
          {
            "duration": 345,
            "error": "Сбой утверждения: элемент не найден",
            "name": "Поиск и фильтрация товаров",
            "softAssertionErrors": 1,
            "status": "failed",
            "steps": [
              {
                "duration": 120,
                "error": null,
                "name": "Поиск по запросу 'электроника'",
                "status": "passed"
              },
              {
                "duration": 100,
                "error": "Элемент 'XYZ' не найден",
                "name": "Применить фильтр 'бренд А'",
                "status": "failed"
              }
            ]
          }
        ],
        "test_summary": {
          "duration": 912,
          "failed": 1,
          "passed": 1,
          "total": 2
        }
      },
      "check_server": {
        "country": "RU",
        "id": "server_id_123",
        "ip_address": "192.168.1.1",
        "region": "Vladivostok",
        "server_metadata": {
          "provider": "CloudProviderX"
        }
      },
      "check_server_id": "server_id_123",
      "created_at": "2025-07-02T12:00:00.000000Z",
      "error_message": null,
      "id": "result_id_abc",
      "response_time": 1234,
      "status": "ok"
    }
  ]
}

Поле	Тип	Описание
results	Массив объектов	Список результатов пошаговой проверок.
results.check_id	Строка	Уникальный идентификатор пошаговой проверки.
results.check_metadata	Объект	Содержит подробные метаданные о выполненной проверке.
results.check_metadata.execution_time	Число	Общее время выполнения проверки в миллисекундах.
results.check_metadata.logs	Массив объектов	Список записей логов, сгенерированных во время выполнения проверки.
level	Строка	Уровень лога (например, "log", "info", "warn", "error").
message	Строка	Сообщение лога.
timestamp	Строка	Временная метка создания записи лога (формат ISO 8601).
results.check_metadata.test_results	Массив объектов	Подробные результаты для каждого отдельного теста в рамках пошаговой проверки.
duration	Число	Продолжительность теста в миллисекундах.
error	Строка / null	Сообщение об ошибке, если тест завершился неудачно. Будет null, если тест пройден.
name	Строка	Название теста.
softAssertionErrors	Число	Количество ошибок, встреченных в тесте.
status	Строка	Статус теста ("passed" (пройден) или "failed" (не пройден)).
steps	Массив объектов	Список отдельных шагов в тесте и их результаты.
duration	Число	Продолжительность шага в миллисекундах.
error	Строка / null	Сообщение об ошибке, если шаг завершился неудачно. Будет null, если шаг пройден.
name	Строка	Название шага.
status	Строка	Статус шага ("passed" (пройден) или "failed" (не пройден)).
results.check_metadata.test_summary	Объект	Сводка по всем тестам в рамках пошаговой проверки.
duration	Число	Общая продолжительность всех тестов в миллисекундах.
failed	Число	Количество не пройденных тестов.
passed	Число	Количество пройденных тестов.
total	Число	Общее количество выполненных тестов.
results.check_server	Объект	Информация о сервере, с которого производилась проверка.
results.check_server.country	Строка	Код страны сервера проверки (например, "RU").
results.check_server.id	Строка	Уникальный идентификатор сервера проверки.
results.check_server.ip_address	Строка	IP-адрес сервера проверки.
results.check_server.region	Строка	Регион размещения сервера проверки (например, "Vladivostok").
results.check_server.server_metadata	Объект	Дополнительные метаданные о сервере.
provider	Строка	Провайдер сервера (например, "RUProvider").
results.check_server_id	Строка	Идентификатор сервера, который выполнил проверку.
results.created_at	Строка	Временная метка создания результата проверки (формат ISO 8601).
results.error_message	Строка / null	Общее сообщение об ошибке, если проверка завершилась неудачно. Будет null, если ошибок нет.
results.id	Строка	Уникальный идентификатор этого конкретного результата проверки.
results.response_time	Число	Общее время выполнения тестов в миллисекундах.
results.status	Строка	Общий статус проверки ("ok" или "error").

Для type: "icmp"

Для ICMP (Ping) проверок check_metadata содержит детальную информацию о результатах ping-проверки.

{
  "check_metadata": {
    "original_host": "example.com",
    "resolved_ip": "93.184.216.34",
    "ip_version_used": "v4",
    "probe_count": 4,
    "probe_interval": 1.0,
    "probe_timeout": 1.0,
    "packet_loss_percent": 0,
    "latency_stats": {
      "avg": 45.5,
      "min": 42.1,
      "max": 51.3,
      "stddev": 3.8,
      "latencies": [42.1, 45.2, 47.8, 51.3]
    }
  }
}

Поле	Тип	Описание
check_metadata	Объект	Содержит подробные метаданные о выполненной ICMP-проверке.
check_metadata.original_host	Строка	Исходный хост или IP-адрес, указанный в проверке.
check_metadata.resolved_ip	Строка	IP-адрес, на который был разрешён хост и на который отправлялись ping-запросы.
check_metadata.ip_version_used	Строка	Использованная версия IP-протокола ("v4" или "v6").
check_metadata.probe_count	Число	Количество отправленных ping-проб.
check_metadata.probe_interval	Число	Интервал между пробами в секундах.
check_metadata.probe_timeout	Число	Таймаут для отдельной пробы в секундах.
check_metadata.packet_loss_percent	Число	Процент потерянных пакетов (диапазон: 0-100).
check_metadata.latency_stats	Объект	Статистика задержки.
check_metadata.latency_stats.avg	Число	Средняя задержка в миллисекундах.
check_metadata.latency_stats.min	Число	Минимальная задержка в миллисекундах.
check_metadata.latency_stats.max	Число	Максимальная задержка в миллисекундах.
check_metadata.latency_stats.stddev	Число	Стандартное отклонение задержки в миллисекундах.
check_metadata.latency_stats.latencies	Массив чисел	Список задержек для каждой успешной пробы в миллисекундах.

Для type: "dns"

Для DNS проверок check_metadata содержит детальную информацию о результатах DNS-запроса и валидации.

{
  "check_metadata": {
    "domain": "example.com",
    "record_type": "A",
    "dns_servers_used": "system_default",
    "validation_mode": "none",
    "authoritative_ns": ["ns1.example.com", "ns2.example.com"],
    "dns_answers": ["93.184.216.34"],
    "validation_result": {
      "passed": true,
      "expected": ["93.184.216.34"],
      "received": ["93.184.216.34"],
      "missing": [],
      "unexpected": []
    }
  }
}

Поле	Тип	Описание
check_metadata	Объект	Содержит подробные метаданные о выполненной DNS-проверке.
check_metadata.domain	Строка	Доменное имя, для которого выполнялся DNS-запрос.
check_metadata.record_type	Строка	Тип запрашиваемой DNS-записи (например, "A", "AAAA", "MX", "TXT").
check_metadata.dns_servers_used	Строка или Массив	Использованные DNS-серверы: "system_default" или список IP-адресов пользовательских DNS-серверов.
check_metadata.validation_mode	Строка	Режим валидации: "none" (валидация не проводилась), "contains_all" или "exact".
check_metadata.authoritative_ns	Массив строк	Отсортированный список авторитативных NS-серверов для домена.
check_metadata.dns_answers	Массив строк	Список полученных DNS-ответов.
check_metadata.validation_result	Объект	Результаты валидации (присутствует только если указаны expected_answers).
check_metadata.validation_result.passed	Булево	Прошла ли валидация успешно.
check_metadata.validation_result.expected	Массив строк	Список ожидаемых ответов.
check_metadata.validation_result.received	Массив строк	Список полученных ответов.
check_metadata.validation_result.missing	Массив строк	Ожидаемые записи, которые отсутствуют в ответе (для режима contains_all и exact).
check_metadata.validation_result.unexpected	Массив строк	Неожиданные записи в ответе (для режима exact).

История статусов проверок

GET /v1/checks/status-history

Получает историю статусов проверок с группировкой по времени и региону. Этот эндпоинт возвращает количество проверок для каждого статуса (ok, failed, degraded, timeout), сгруппированное по региону и временным интервалам. Если не указан check_id, возвращает метрики для всех проверок в организации.

Параметры запроса

Вы можете управлять выводом данных, используя следующие параметры запроса:

• check_id: string (опционально) — ID конкретной проверки для фильтрации данных. Если не указан, будут возвращены данные по всем проверкам.
• start_date: string (опционально) — Начальная дата и время в формате ISO 8601 (например, 2025-05-25T00:00:00Z). По умолчанию — 24 часа назад.
• end_date: string (опционально) — Конечная дата и время в формате ISO 8601 (например, 2025-05-26T00:00:00Z). По умолчанию — текущее время.
• region: string (опционально) — Регион для фильтрации данных.
• status: string (опционально) — Статус для фильтрации данных (ok, failed, degraded, timeout).

---

Объект

Ответ на запрос GET /v1/checks/status-history представляет собой объект, где ключи — это названия регионов, а значения — массивы с историей статусов для этого региона.

{
	"US": [
		{
			"time_bucket": "2025-05-25T12:00:00Z",
			"total_count": 150,
			"ok_count": 145,
			"failed_count": 2,
			"degraded_count": 3,
			"timeout_count": 0
		},
		{
			"time_bucket": "2025-05-25T13:00:00Z",
			"total_count": 152,
			"ok_count": 150,
			"failed_count": 1,
			"degraded_count": 1,
			"timeout_count": 0
		}
	],
	"Europe": [
		{
			"time_bucket": "2025-05-25T12:00:00Z",
			"total_count": 120,
			"ok_count": 118,
			"failed_count": 2,
			"degraded_count": 0,
			"timeout_count": 0
		}
	],
	"Unknown": [
		{
			"time_bucket": "2025-05-25T12:00:00Z",
			"total_count": 5,
			"ok_count": 5,
			"failed_count": 0,
			"degraded_count": 0,
			"timeout_count": 0
		}
	]
}

Поля

Поле	Тип объекта	Описание
{region_name}	array	Массив временных интервалов с данными. {region_name} — это название региона, например, US, Europe или Unknown.

---

Массив {region_name}

Каждый элемент в массиве {region_name} представляет собой временной интервал с агрегированными данными.

Поле	Тип объекта	Описание
time_bucket	string (ISO 8601)	Начало временного интервала.
total_count	number	Общее количество проверок в данном временном интервале.
ok_count	number	Количество проверок со статусом ok.
failed_count	number	Количество проверок со статусом failed.
degraded_count	number	Количество проверок со статусом degraded.
timeout_count	number	Количество проверок со статусом timeout.

История Времени Ответа (или выполнения тестов) проверки

GET /v1/checks/{check_id}/response-times

Получает агрегированные метрики времени ответа для конкретной проверки, сгруппированные по региону. Возвращает среднее значение, 95-й и 99-й процентили времени ответа для каждого временного интервала и региона.

Параметры пути

• check_id: string (обязательный) — Уникальный идентификатор проверки, для которой необходимо получить метрики.

Параметры запроса

Вы можете управлять выводом данных, используя следующие параметры запроса:

• start_date: string (опционально) — Начальная дата и время в формате ISO 8601 (например, 2025-05-25T00:00:00Z). По умолчанию — 24 часа назад.
• end_date: string (опционально) — Конечная дата и время в формате ISO 8601 (например, 2025-05-26T00:00:00Z). По умолчанию — текущее время.
• region: string (опционально) — Регион для фильтрации данных.
• status: string (опционально) — Статус для фильтрации данных (ok, failed, degraded, timeout).

Объект

Ответ на запрос GET /v1/checks/{check_id}/response-times представляет собой объект, где ключи — это названия регионов, а значения — массивы с агрегированными данными времени ответа для этого региона.

{
	"US": [
		{
			"time_bucket": "2025-05-25T12:00:00Z",
			"avg_response_time": 150.5,
			"p95_response_time": 210.0,
			"p99_response_time": 350.0
		},
		{
			"time_bucket": "2025-05-25T13:00:00Z",
			"avg_response_time": 148.2,
			"p95_response_time": 205.5,
			"p99_response_time": 340.2
		}
	],
	"Europe": [
		{
			"time_bucket": "2025-05-25T12:00:00Z",
			"avg_response_time": 180.1,
			"p95_response_time": 250.8,
			"p99_response_time": 400.1
		}
	],
	"Unknown": [
		{
			"time_bucket": "2025-05-25T12:00:00Z",
			"avg_response_time": 160.0,
			"p95_response_time": 220.0,
			"p99_response_time": 360.0
		}
	]
}

Поля

Поле	Тип объекта	Описание
{region_name}	array	Массив временных интервалов с данными. {region_name} — это название региона, например, US, Europe или Unknown.

---

Массив {region_name}

Каждый элемент в массиве {region_name} представляет собой временной интервал с агрегированными данными.

Поле	Тип объекта	Описание
time_bucket	string (ISO 8601)	Начало временного интервала.
avg_response_time	number	Среднее время ответа в миллисекундах.
p95_response_time	number	95-й процентиль времени ответа в миллисекундах.
p99_response_time	number	99-й процентиль времени ответа в миллисекундах.