KeelsonDocs
    Judge Mode

    API reference Evidence

    Observe a product through Channel3

    POST/v1/observations/channel3

    Asks Channel3 about the product page once (live fetch if its data is older than an hour, eight seconds at most), compares variant, price, availability and brand with what the agent saw, stores the observation and queues RFC 3161 tokens over its hash. Channel3 is third-party testimony: it is shown in the countersigned trace and never changes a decision.

    Headers

    Content-Typeapplication/jsonRequired
    idempotency-keystringRequired
    Idempotency-KeystringRequired
    1 to 255 characters. A retry with the same key returns the first answer.

    Request body

    application/json

    mandateIdstringRequired
    urlstringRequired
    The product page the agent is on.
    agentViewobjectRequired
    What the agent saw on the page.

    Responses

    • 201The observation and its sealed evidence item
    • 404No such mandate of an operator this client linked
    • 409The mandate is not active
    • 422The request is invalid
    • 429Too many observations for this mandate, or today for this client
    • 503Channel3 is not configured, or the rate limit store is unreachable

    201 response

    idstringRequired
    statusstringRequired
    unavailable when Channel3 did not answer in time or failed; it is stored too.One of okunavailable
    itemobjectRequired
    The sealed evidence item to add to the capture's items, after har, before buildManifest and POST /v1/evidence.
    comparisonobjectRequired