Resource file downloads

Example: Handle the supplied link as file bytes

Use the email/hash from an existing link; RESOURCE_FILE_HASH is an obvious placeholder supplied separately, not a generated credential. The expected result is stored bytes and its media type, with the filename from the matched record. No synthetic JSON success body is fabricated.

curl --get "${WALLKIT_API_BASE}/api/v1/resource/file/download" \
  --data-urlencode "email=reader@example.com" \
  --data-urlencode "hash=${RESOURCE_FILE_HASH}" \
  --dump-header download-headers.txt --output download-body.bin
# Inspect HTTP status and Content-Type before interpreting download-body.bin.

const url = new URL(`${process.env.WALLKIT_API_BASE}/api/v1/resource/file/download`);
url.searchParams.set("email", "reader@example.com");
url.searchParams.set("hash", process.env.RESOURCE_FILE_HASH);
const response = await fetch(url);
const media = response.headers.get("content-type") || "";
if (media.includes("application/json")) {
  console.log(response.status, await response.json());
} else if (!response.ok) {
  console.log(response.status, await response.text());
} else {
  const bytes = await response.arrayBuffer();
  console.log(response.status, media, bytes.byteLength);
  // Inspect expected media/content; a non-JSON body is not proof of a complete file.
}

import os, json
from urllib.parse import urlencode
from urllib.request import Request, urlopen
from urllib.error import HTTPError

query = urlencode({"email": "reader@example.com", "hash": os.environ["RESOURCE_FILE_HASH"]})
request = Request(os.environ["WALLKIT_API_BASE"] + "/api/v1/resource/file/download?" + query, method="GET")
try:
    with urlopen(request) as response:
        media = response.headers.get("Content-Type", "")
        body = response.read()
        if "application/json" in media:
            print(response.status, json.loads(body))
        else:
            print(response.status, media, len(body))
            # Inspect expected file content; length/status alone do not prove completeness.
except HTTPError as error:
    body = error.read()
    if "application/json" in error.headers.get("Content-Type", ""):
        print(error.code, json.loads(body))
    else:
        print(error.code, body.decode("utf-8", errors="replace"))

Illustrative header/body shape only, with media dependent on the stored object:

Content-Type: <stored ContentType>
Content-Disposition: attachment; filename=<stored original_name>
Pragma: public

<stored file bytes>