ConverterHQDevelopers
API v1

Obserwowalność

Koreluj requests, Jobs, Tasks, usage i webhooks w produkcji.

Observability zaczyna się od korelowalnych IDs i trwałego stanu. Zachowaj X-Request-ID oraz client_reference_id, by przejść od incydentu do konkretnego wykonania.

Korelacja requestów

Loguj X-Request-ID, HTTP status, endpoint, czas i project_id bez zapisywania API secrets ani zawartości pliku.

Stan Jobs i Tasks

Monitoruj queue latency, czas engine, attempts, error codes i success rate per pair. Retry ma pozostać widoczny, a nie nadpisywać historię.

Dostawa eventów

Mierz błędy signature, 2xx rate, latency handlera, retry backlog i wiek ostatniego eventu. Po naprawie incydentu użyj replay.

Użycie i koszt

Śledź calls, credits, bytes i concurrency per project. Alerty kosztowe powinny używać autorytatywnych liczników komercyjnych, nie lokalnych estymacji.