Endpoint REST API

GET /v1/sources

Źródła ruchu z bieżącego okna danych na żywo, wraz z klasyfikacją i opcjonalnymi wierszami podrzędnymi.

Żądanie

GET https://api.nowmetrix.com/v1/sources?site=TRACKER_ID

Ten endpoint służy do ustalenia, skąd pochodzą czytelnicy korzystający obecnie z witryny, bez pobierania pełnego zestawu danych o najpopularniejszych stronach w czasie rzeczywistym.

Uwierzytelnianie

Wymagany jest klucz API przekazany w nagłówku Authorization: Bearer nm_YOUR_KEY.

Parametry zapytania

Nazwa Typ Wymagane Opis
site string wymagany Identyfikator trackera. Klucz API musi zapewniać dostęp do tego trackera.

Przykład cURL

curl -H "Authorization: Bearer nm_YOUR_KEY" \
  "https://api.nowmetrix.com/v1/sources?site=TRACKER_ID"

Przykładowa odpowiedź

{
  "site": "TRACKER_ID",
  "updated_at": "2026-06-26T12:24:30+00:00",
  "total_visitors": 128,
  "sources": [
    {
      "medium": "search",
      "source": "Google Search",
      "count": 46,
      "percent": 36,
      "children": [
        {
          "label": "google.com",
          "count": 28
        },
        {
          "label": "google.ch",
          "count": 18
        }
      ]
    },
    {
      "medium": "social",
      "source": "social.example",
      "count": 24,
      "percent": 19,
      "children": []
    },
    {
      "medium": "newsletter",
      "source": "morning-briefing",
      "count": 17,
      "percent": 13,
      "children": [
        {
          "label": "daily-edition",
          "count": 11
        },
        {
          "label": "evening-edition",
          "count": 6
        }
      ]
    }
  ]
}

Pola odpowiedzi

Pole Typ Opis
site string Identyfikator trackera użyty w żądaniu.
updated_at string Znacznik czasu UTC wskazujący moment wygenerowania danych.
total_visitors integer Liczba aktywnych użytkowników uwzględnionych w zestawieniu źródeł.
sources[] array<object> Wiersze źródeł posortowane według liczby.
sources[].medium string Kategoria źródła, na przykład search, social, newsletter, (none) lub (not set), gdy utm_source nie zawiera utm_medium.
sources[].source string Znormalizowana etykieta źródła.
sources[].count integer Liczba aktywnych użytkowników pochodzących z tego źródła.
sources[].percent integer Zaokrąglony odsetek łącznej liczby odwiedzających.
sources[].children[] array<object> Opcjonalne wiersze ze szczegółami, takie jak nazwy hostów wyszukiwarek lub nazwy kampanii.
sources[].children[].label string Etykieta wiersza podrzędnego.
sources[].children[].count integer Liczba użytkowników w wierszu podrzędnym.

Aktualność danych i buforowanie

Odpowiedzi są mikrobuforowane osobno dla każdego trackera przez 8 sekund. Odpowiedź zawiera również nagłówek X-NowMetrix-Microcache z wartością HIT lub MISS.

Błędy

HTTP Kod Opis
400 site_required Brakuje wymaganego parametru site.
401 missing_token Brakuje nagłówka Authorization.
401 invalid_token Token jest nieprawidłowy lub został unieważniony.
403 site_not_authorized Klucz API nie zapewnia dostępu do tego trackera.
429 rate_limit_exceeded Przekroczono limit zapytań.
503 redis_unavailable Zaplecze obsługujące dane w czasie rzeczywistym jest tymczasowo niedostępne. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}