ServicesScanDALHTTP APIBlobs

Read a blob

POST
/blobs/read

Stream the bytes of a blob that a Table owns, or of a byte range of it. Check a whole read against the blob's digest and a range against its length; a stream that ends early is incomplete.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Request Body

application/json
  1. body
blob*

A reference to a payload that one Table owns. It is never a download URL. digest is the BLAKE3 digest of the whole payload, as lowercase hexadecimal. The payload is the object blobs/<objectId> under the Table's root, or attempts/<attempt>/blobs/<objectId> when an upload into a write attempt stored it.

range?|null
storage?|null

Response Body

Success

response?fileapplication/octet-stream
Formatbinary
curl -X POST 'https://scandal.spiraldb.dev/blobs/read' \  -H 'Content-Type: application/json' \  -d '{  "blob": {    "digest": "string",    "mediaType": "string",    "objectId": "e39ea5f2-2188-47f8-add0-f1976630af5e",    "size": "string",    "tableId": "073fbfcb-cd05-4203-be18-a1ce6f8e4d2d"  }}'
"string"