Hub Log Middleware

API Middleware for querying, analyzing, and downloading Airflow logs on the Fracttal platform.

Overview

Hub Log Middleware is an integration layer that exposes unified RESTful endpoints for querying, analyzing, and downloading Airflow logs.

Base URL

http://<host>:<port>/api/v1

Endpoint groups

Group	Prefix	Description
DAGs	/api/v1	DAG and run navigation by company
Runs	/api/v1/runs	Artifacts and advanced run search
Artifacts	/api/v1/artifacts	Artifact download and access
Problems	/api/v1/problems	RFC 9457 error catalog

Authentication

All endpoints require a Bearer Token in the Authorization header. See Authentication.

Key concepts

Before consuming the API, we recommend reading:

• Pagination — how to iterate large lists and use the stream.
• Filters & dates — date ranges, levels, text search, and ordering.
• Error handling — RFC 9457 error format and how to handle each code.

Health check

GET /health

Returns the API status.

{
  "status": "healthy",
  "app_name": "Hub Log Middleware",
  "version": "1.0.0",
  "environment": "production"
}

Interactive documentation

The API exposes an interactive testing interface. Request the access URL from the team responsible for the service.