The unified machine record for one observation: subject, grade, findings (top one in full without a licence), capabilities with verification, evidence roots and verifier links

get/api/v1/machine-record

Request

  • Base URL: https://crawlcheck.io
  • URL: https://crawlcheck.io/api/v1/machine-record
  • Auth: none required

Query parameters

idstring
domainstring
format'json' | 'otel' | 'openlineage' | 'jsonld'

json (default, MachineRecordV1); otel = OTLP/JSON traces (scan, stage and rule spans; rule spans link to the fetch spans they read); openlineage = a START and a COMPLETE RunEvent (fetches as input datasets, the report as the output dataset; facets at /schemas/openlineage-facets.json); jsonld = PROV-O + schema.org JSON-LD. Built from the record this caller may see: locked findings are omitted and counted

Response

MachineRecordV1

kind'crawlcheck-machine-record' required
versionstring required
subjectobject required
observationobject required
freshnessobject

observed_at, age_hours, latest_report_id, is_latest, newer_scan_exists, last_second_reading_at

fix_impactobject nullable

With a licence: one line per fix that would change this record, best first (findings and rows it clears, other fixes some rows also need, score and letter after, root causes closed, certificate criteria flipped). Without: {fixes_available, best_single_fix {letter_after, score_after, findings_cleared, rows_cleared}} and no names

score_ledgerobject nullable

score, letter, cap and the points each failing row moves (rows open with a licence); each open finding carries score_effect {points: 0, cap, binding, letter_without_it, says}

confidenceobject

counts and ratios plus vantages; no composite number; levels: contested | cross_vantage_confirmed | reproduced | single_reading

contradictionsobject

site (the site contradicts itself) and between_networks_open (observers disagree), for findings this caller can open

findings_summaryobject nullable
findings_withheldstring nullable
capabilitiesobject required
evidenceobject required
accessobject required

Changes

No recorded changes to this operation across all 1 revision of this API.