Operate with HTTP and OpenAPI

Operator check

Choose one declared operation and hold the artifact

Use the generated OpenAPI record to bind exact method, path, request schema, response schema, auth model, stable errors, and idempotency field; separately hold the complete artifact bytes before transport.

Substantive records: /reference/http-openapi · /reference/stable-errors

Expected: The HTTP contract and stronger held input are exact before transport.

Exact mechanic

Verify the held bytes locally

import { createReceizClient } from "@receiz/sdk";

const encoded = process.env.RECEIZ_ARTIFACT_BASE64;
if (!encoded) throw new Error("RECEIZ_ARTIFACT_BASE64 is required");
const artifactBytes = Uint8Array.from(Buffer.from(encoded, "base64"));
const receiz = createReceizClient();
const verification = await receiz.verification.verifyArtifact(artifactBytes);
if (verification.status !== "verified-artifact") throw new Error(verification.status);
console.log(verification.status);

Mechanic

receiz.verification.verifyArtifact

Authentication and account boundary

Account-free local verification.

Exact source

node_modules/@receiz/sdk/dist/index.d.ts · SHA-256 3278d551808697d9936ffdf75931358c903bb0cc5a211191b611d4474895f6be

Expected: Local SDK verification returns its exact status for the enclosing bytes before any HTTP comparison.

Exact mechanic

Compare the HTTP verification projection

curl --fail-with-body --request POST "https://receiz.com/api/document-verify"   --form "file=@${RECEIZ_ARTIFACT_PATH:?RECEIZ_ARTIFACT_PATH is required}"

Mechanic

POST /api/document-verify

Authentication and account boundary

No Auth

Exact source

receiz-docs/generated/openapi-reference.json · SHA-256 2278eb9ab1dfcc90d61d4a6f9daac1bc55e17aeeab0d2d5d39228f88654bc20a

Expected: The no-auth route returns the documented verification response or exact stable failure for comparison with the stronger local verdict.

Operator check

Qualify transport behavior

Test wrong auth, invalid schema, oversized body, idempotency replay where applicable, stable error mapping, timeout, and local/network result disagreement.

Substantive records: /reference/operations-receipts · /trust/conformance

Expected: Transport failures remain distinct from proof verification.