The Asset API delivers catalog objects in bounded chunks via /api/v1/chunks. All calls are HTTPS, method GET, response application/octet-stream or application/json.
| Name | Placement | Meaning |
|---|---|---|
s | Query | Stream session token (8–12 chars, Base62 alphanumeric) |
p | Query | Chunk page sequence number: ?p=0&s=..., ?p=1&s=... |
X-Request-Id | Header | Per-request payload frame; required for chunked transfers |
X-Cache | Header | Cache behavior hint token (_dc=...); pass through unchanged |
curl -H "X-Request-Id: 01HWZ8..." \
-H "X-Cache: _dc=aB3fK9qL2mN7" \
"https://node.example/api/v1/chunks?p=0&s=k9Qm2xWp7A"
Chunk responses are never cached (Cache-Control: no-store). On 503/504 retry with the same X-Request-Id; the node deduplicates in-flight pulls.