endpoints

Overview ¶

Package endpoints is a knowledgebase.Extractor that classifies a crawled request as an API endpoint (REST, GraphQL, SOAP, AJAX/XHR) by inspecting method, URL, headers, and content types. Emits per-response, one entry per qualifying request.

Output schema (all values strings unless noted):

class        : "rest" | "graphql" | "soap" | "xhr"
method       : uppercase HTTP verb
url          : request URL with userinfo and fragment stripped
content_type : lowercased media type without parameters (optional)
auth         : lowercased auth scheme, e.g. "bearer" / "basic" (optional)
params       : []string of query parameter names in first-seen order (optional)

The extractor is read-only with respect to its inputs: it MUST NOT mutate req or resp (headers, body, URL).