QYL Observability API

REST API for traces, logs, metrics, and deployments.

REST API for the qyl observability platform.

Version: 2026-01-15

Base URLs

Environment	URL
Production	https://api.qyl.dev
Staging	https://api.staging.qyl.dev

Authentication

All endpoints are public. No authentication required.

Endpoints

Category	Endpoints	Description
Health	3	Liveness, readiness probes
Traces	4	Distributed trace queries
Logs	5	Log search, aggregation
Metrics	3	Metrics queries
Sessions	4	User session tracking
Errors	5	Error group management
Exceptions	2	Exception statistics
Deployments	5	DORA metrics
CI/CD	2	Pipeline monitoring
Streaming	7	SSE real-time events
Services	4	Service registry

Pagination

Cursor-based pagination on list endpoints:

{
  "items": [...],
  "has_more": true,
  "next_cursor": "abc123"
}

Parameter	Type	Default
limit	int	100 (max: 1000)
cursor	string	—

Response Headers

Header	Purpose
X-Trace-Id	Distributed tracing
X-Request-Id	Support reference

Errors

{
  "code": "VALIDATION_ERROR",
  "message": "Description",
  "details": {}
}

Status	Meaning
200	Success
400	Validation error
404	Not found
500	Server error