klyrek-api 0.1.0

API discovery and endpoint inventory for the Klyrek ecosystem

klyrek-api

API discovery and endpoint inventory. Three independent, composable pieces:

• openapi — parses an OpenAPI/Swagger JSON spec's paths object into Endpoint records (method, params, base path handled for both Swagger 2.0 basePath and OpenAPI 3.x servers[]).
• discovery — probes a small, curated set of well-known paths where a spec or an API root commonly lives (/openapi.json, /swagger.json, /api/v1, ...), all scope-checked through klyrek-http.
• graphql — probes common GraphQL paths with a minimal {__typename} query and confirms by the response shape ({"data": ...} / {"data": ..., "errors": ...}), not just a 200.

inventory.build_api_inventory() runs all of the above against a target and returns a deduplicated list[Endpoint]. classify.is_rest_like() is a separate, standalone heuristic for tagging URLs already discovered by klyrek-crawler as API-shaped (/api/, /v1/, numeric ID segments) without making any additional requests.

from klyrek_api.inventory import build_api_inventory

endpoints = build_api_inventory(client, "https://target.com/")