{"openapi":"3.0.3","info":{"title":"idlidu Kubernetes API","version":"2026.09.0","description":"Point-in-time Kubernetes ecosystem commercial facts & registry archive. Not a security rating; not a cost guarantee."},"servers":[{"url":"https://k8s-api.idlidu.com"}],"paths":{"/v1/health":{"get":{"summary":"Health","responses":{"200":{"description":"OK"}}}},"/v1/openapi.json":{"get":{"summary":"OpenAPI document","responses":{"200":{"description":"OpenAPI 3 JSON"}}}},"/v1/public/sample/entities":{"get":{"summary":"Unauthenticated sample entities","responses":{"200":{"description":"Tiny entity slice"}}}},"/v1/usage":{"get":{"summary":"Usage and entitlements","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Usage snapshot"},"401":{"description":"Unauthorized"},"429":{"description":"Quota exceeded"}}}},"/v1/billing/portal":{"get":{"summary":"Billing portal placeholder","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Portal URL"}}}},"/v1/billing/webhook":{"post":{"summary":"Checkout webhook (vendor-agnostic)","responses":{"200":{"description":"Processed"},"400":{"description":"Invalid JSON"}}}},"/v1/entities":{"get":{"summary":"List entities","security":[{"bearerAuth":[]}],"parameters":[{"name":"kind","in":"query","schema":{"type":"string","enum":["managed_k8s","helm_chart","oci_artifact","catalog_project"]}}],"responses":{"200":{"description":"Entity list"},"401":{"description":"Unauthorized"}}}},"/v1/entities/{slug}":{"get":{"summary":"Get entity","security":[{"bearerAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Entity"},"403":{"description":"Outside plan universe"},"404":{"description":"Not found"}}}},"/v1/entities/{slug}/events":{"get":{"summary":"Entity change events","security":[{"bearerAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"from","in":"query","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Events"},"403":{"description":"History depth exceeds plan"},"404":{"description":"Not found"}}}},"/v1/entities/{slug}/as-of":{"get":{"summary":"Structured view as of a point in time","security":[{"bearerAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"at","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"As-of observation"},"400":{"description":"Missing at"},"403":{"description":"Outside history depth"},"404":{"description":"No observation"}}}},"/v1/indices/{id}":{"get":{"summary":"Published index series","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"k8s.managed.list_price.churn"}}],"responses":{"200":{"description":"Index series"},"403":{"description":"Growth+ required"},"404":{"description":"Unknown index"}}}},"/v1/export/bulk":{"get":{"summary":"Bulk export (Archive)","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Entities + events"},"403":{"description":"Archive required"}}}},"/v1/internal/seed-key":{"post":{"summary":"Admin: mint durable API key into D1","description":"Requires x-admin-secret. Soft launch without PSP.","responses":{"200":{"description":"Key minted (shown once)"},"401":{"description":"Unauthorized"},"503":{"description":"D1 required"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key with prefix idl_k8s_"}}}}