Integracja

REST API

Zdarzenia i transakcje przez REST API

Dostępna bezpłatnie Dowolny klient HTTP

Instalacja

# Zgłoszenie kontrolnego wyjątku

curl -X POST https://dockray.io/api/v1/TWOJ_TOKEN/project \
  -H 'Authorization: Bearer TWOJ_KLUCZ_PRYWATNY' \
  -H 'Content-Type: application/json' \
  -d '{
    "environment": "production",
    "sdk": {"name": "custom-http-client", "version": "1.0.0"},
    "contexts": {
      "runtime": {"name": "php", "version": "8.4"},
      "os": {"name": "Linux", "version": "6.1"}
    },
    "exception": {
      "values": [{
        "type": "RuntimeException",
        "value": "DockRay connection test",
        "stacktrace": {"frames": []}
      }]
    },
    "request": {
      "url": "https://api.example.com/api/orders",
      "method": "POST",
      "headers": {"content-type": ["application/json"]}
    }
  }'

REST API jest bezpośrednim interfejsem ingestu DockRay dla aplikacji, usług i urządzeń, dla których nie ma dedykowanej biblioteki lub wtyczki. Endpoint project przyjmuje błędy i wyjątki wraz ze stosem wywołań, środowiskiem, informacjami o SDK i runtime, kontekstem żądania oraz opcjonalnymi danymi użytkownika. Endpoint transaction zapisuje obsłużone żądania HTTP: nazwę transakcji, czas zdarzenia, adres, metodę, kod odpowiedzi, środowisko oraz kontekst techniczny. Dane te pozwalają analizować wielkość ruchu, rozkład odpowiedzi 2xx–5xx i historię żądań dla projektu. Oba endpointy używają formatu zbliżonego do payloadów Sentry, przyjmują JSON w postaci jawnej lub skompresowanej gzipem i korzystają z tego samego mechanizmu uwierzytelniania kluczem prywatnym projektu.

Jak tego użyć

Wyjątki integracja raportuje sama. To jest do zgłoszeń, które chcesz wysłać świadomie.

bash

# Rejestracja transakcji HTTP
curl -X POST https://dockray.io/api/v1/TWOJ_TOKEN/transaction \
  -H 'Authorization: Bearer TWOJ_KLUCZ_PRYWATNY' \
  -H 'Content-Type: application/json' \
  -d '{
    "transaction": "POST /api/orders",
    "sent_at": "2026-09-01T12:30:00+00:00",
    "environment": "production",
    "tags": {"http.status_code": 201},
    "sdk": {"name": "custom-http-client", "version": "1.0.0"},
    "contexts": {
      "runtime": {"name": "php", "version": "8.4"},
      "os": {"name": "Linux", "version": "6.1"},
      "trace": {
        "data": {
          "url": "https://api.example.com/api/orders",
          "method": "POST"
        }
      }
    },
    "user": {"id": "account-1842"}
  }'