> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # API метрик обогащения событий > Получите за период счётчики приёма событий и обогащения IP: долю попаданий в кеш, соотношение уникальных IP и свежие запросы на тысячу событий в Didit. Промпт для API получения метрик обогащения событий Скопировать промпт в буфер обмена 
  \`Read the event ingestion and IP-enrichment counters of my Didit application for a period.

  Endpoint:
  GET [https://verification.didit.me/v3/events/enrichment-metrics/?days=30](https://verification.didit.me/v3/events/enrichment-metrics/?days=30)

  Authentication:
  Use the x-api-key header with my Didit API key. A scoped key needs transactions: read.

  Goal:

  * Monitor event volume and confirm that IP enrichment is resolved once per unique address rather than once per event, for a usage dashboard or an alert.

  Behavior:

  * days defaults to 30 and is clamped to 1-365; a non-integer value falls back to 30.
  * The period covers today plus the previous days days, by UTC calendar day.
  * Counters are summed over every lane (server, batch and device).
  * The three ratios are null when their denominator is zero.

  Example call:
  curl -X GET "[https://verification.didit.me/v3/events/enrichment-metrics/?days=30](https://verification.didit.me/v3/events/enrichment-metrics/?days=30)" \
  -H "x-api-key: YOUR\_API\_KEY"

  What to read from the response:

  * events\_ingested - new events stored (replays are not counted).
  * events\_rejected - items rejected inside batch requests (a rejected single-event request is not counted).
  * enrichment\_lookups - events whose public IP address was resolved; enrichment\_cache\_hits - answered from the cache; enrichment\_provider\_calls - needed a fresh resolution.
  * enrichment\_skipped\_low\_value - low-value telemetry whose address was not cached; it never triggers a lookup of its own.
  * unique\_ips\_seen - distinct addresses that needed a fresh resolution.
  * cache\_hit\_rate, unique\_ip\_ratio, provider\_calls\_per\_1k\_events - the ratios.
  * period\_days - the period actually applied.

  Failure modes:

  * 401 - the API key has expired.
  * 403 - missing API key (a wrong, revoked or expired key gets 401), or a scoped key without transactions: read.

  Side effects: none. This is a pure read.

  For the full integration shape, see /integration/integration-prompt.\`
Вставьте в Business Console показывает те же цифры над списком событий. См. [Обогащение IP-адреса](https://docs.didit.me/ru/transaction-monitoring/events.md#обогащение-ip) в руководстве по приему событий, где объясняется, почему телеметрия с низкой ценностью получает данные обогащения только тогда, когда другое событие уже определило адрес, а также [Обогащение IP-адреса](https://docs.didit.me/ru/transaction-monitoring/ip-enrichment.md) о полях, которые содержит обогащённый адрес. ## OpenAPI ````yaml ru/openapi-25.json GET /v3/events/enrichment-metrics/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: >- API верификации личности. Аутентификация выполняется с помощью заголовка x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/events/enrichment-metrics/: get: tags: - Monitoring Events summary: Получить метрики обогащения событий description: >- Возвращает счётчики приёма событий и обогащения IP для вашего приложения за определённый период, просуммированные по всем каналам (server, batch и device), позволяя отслеживать объём событий и убедиться, что обогащение выполняется один раз на уникальный адрес, а не для каждого события. Период охватывает сегодняшний день и предыдущие дни в количестве `days`, считая по календарной дате в UTC. Три соотношения равны null, если их знаменатель равен нулю. API-ключ с ограниченной областью действия требует `transactions: read`. См. [Обогащение IP](https://docs.didit.me/ru/transaction-monitoring/events#обогащение-ip). operationId: get_monitoring_event_enrichment_metrics parameters: - name: days in: query required: false description: >- Длина периода в днях. По умолчанию 30; значения ограничены диапазоном от 1 до 365, а при нецелом значении используется 30. Применённое значение возвращается как `period_days`. schema: type: integer default: 30 minimum: 1 maximum: 365 example: 30 responses: '200': description: Счётчики и соотношения за период. content: application/json: schema: type: object required: - events_ingested - events_rejected - enrichment_lookups - enrichment_cache_hits - enrichment_provider_calls - enrichment_skipped_low_value - unique_ips_seen - period_days - cache_hit_rate - unique_ip_ratio - provider_calls_per_1k_events properties: events_ingested: type: integer description: >- Сохранены новые события. Идемпотентные повторные отправки не учитываются. events_rejected: type: integer description: >- Элементы, отклонённые внутри пакетных запросов (серверный поток и поток устройства). Отклонённый запрос с одним событием не учитывается. enrichment_lookups: type: integer description: >- События, чей публичный IP-адрес был определён, из кэша или заново. enrichment_cache_hits: type: integer description: Поисковые запросы, ответы на которые получены из кэша. enrichment_provider_calls: type: integer description: Поисковые запросы, потребовавшие нового разрешения адреса. enrichment_skipped_low_value: type: integer description: >- События телеметрии с низкой ценностью, адрес которых ещё не был известен. Они никогда сами по себе не инициируют новое разрешение адреса. unique_ips_seen: type: integer description: Адреса, потребовавшие повторного разрешения. period_days: type: integer description: Значение `days`, применённое после ограничения диапазона. cache_hit_rate: type: number nullable: true description: >- `enrichment_cache_hits / enrichment_lookups`, округлённое до 4 знаков после запятой. Null, если запросов не было. unique_ip_ratio: type: number nullable: true description: >- `unique_ips_seen / events_ingested`, округлённое до 4 знаков после запятой. Null, если события не принимались. provider_calls_per_1k_events: type: number nullable: true description: >- Количество актуальных решений на 1000 полученных событий, округлённое до 2 знаков после запятой. Null, если события не поступали. examples: Last 30 days: value: events_ingested: 128450 events_rejected: 214 enrichment_lookups: 41230 enrichment_cache_hits: 40118 enrichment_provider_calls: 1112 enrichment_skipped_low_value: 74320 unique_ips_seen: 1112 period_days: 30 cache_hit_rate: 0.973 unique_ip_ratio: 0.0087 provider_calls_per_1k_events: 8.66 No events yet: value: events_ingested: 0 events_rejected: 0 enrichment_lookups: 0 enrichment_cache_hits: 0 enrichment_provider_calls: 0 enrichment_skipped_low_value: 0 unique_ips_seen: 0 period_days: 30 cache_hit_rate: null unique_ip_ratio: null provider_calls_per_1k_events: null '401': description: >- Срок действия API-ключа с ограниченной областью действия истёк. Только при истёкшем сроке действия ключа возвращается `401`; при отсутствии ключа или его недействительности возвращается `403`. content: application/json: examples: Expired key: value: detail: This API key has expired. '403': description: >- Отсутствует `x-api-key` (неверный, отозванный или истекший ключ возвращает `401`), ключ с ограниченной областью действия без права `transactions: read`, ключ, ограниченный определёнными сценариями или одобренными сессиями (такой ключ никогда не получает доступ к данным мониторинга транзакций), либо запрос отправлен не из списка разрешённых адресов ключа. content: application/json: examples: Missing or invalid API key: value: detail: You do not have permission to perform this action. Scoped key without access: value: detail: This API key has no read access to transactions. Key limited to workflows or approved sessions: value: detail: >- This API key only reaches sessions inside its workflow or status limits, so it can't use this endpoint. IP not allowed: value: detail: This API key can't be used from this IP address. '429': description: >- Лимит запросов превышен: `GET`-запросы разделяют лимит в 600 запросов в минуту на один API-ключ. Подождите `Retry-After` секунд, затем повторите попытку. headers: Retry-After: description: Количество секунд ожидания перед повторной попыткой. schema: type: integer minimum: 1 example: 30 content: application/json: examples: Throttled: value: detail: >- GET request rate limit exceeded. You can make up to 600 requests per minute. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X GET 'https://verification.didit.me/v3/events/enrichment-metrics/?days=30' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.monitoring_events.retrieve_enrichment_metrics() print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.monitoringEvents.retrieveEnrichmentMetrics(); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.MonitoringEvents.RetrieveEnrichmentMetrics(ctx, didit.MonitoringEventsRetrieveEnrichmentMetricsParams{})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: |- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.monitoringEvents().retrieveEnrichmentMetrics(); System.out.println(result); - lang: php label: PHP source: |- monitoringEvents->retrieveEnrichmentMetrics(); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.monitoring_events.retrieve_enrichment_metrics puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.MonitoringEvents.RetrieveEnrichmentMetricsAsync(); Console.WriteLine(JsonSerializer.Serialize(result)); components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.