VEvetnio
uploaded-files

Get a download URL for an uploaded file

Returns a short-lived presigned URL the client can use to download the file directly from S3, bypassing the Vetnio API. Prefer this over streaming the file through the API — it keeps latency low and avoids large-payload bandwidth on our servers.

get/workspaces/{workspaceId}/consultations/{consultationId}/uploaded-files/{fileName}/download-url

Request

  • Base URL
    https://vetnio.com/api/v2
  • URL
    https://vetnio.com/api/v2/workspaces/{workspaceId}/consultations/{consultationId}/uploaded-files/{fileName}/download-url
  • Auth
    HTTP bearer

Path parameters

workspaceIdstring required

Opaque identifier of the Vetnio workspace (veterinary clinic) that owns the resource. Scopes every request — callers can only access files under workspaces they are a member of.

Example:furunculotic-loud-chihuahua
consultationIdstring required

Identifier of the consultation (a single veterinary visit) the file is attached to. The consultation must belong to the same workspace as the authenticated caller.

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890
fileNamestring required

Stable internal identifier for the file — a server-generated UUID returned by initUpload. Used in every subsequent endpoint (finalize, download, delete). Not intended for display; use originalFileName for that.

Example:8f1c4a60-7e3b-4b6f-9a9d-6d9f3c8b2e4a

Response

Presigned download URL with display metadata.

urlstring uri required

Presigned S3 URL valid for 1 hour that lets the client GET the original file bytes. Call this endpoint again to obtain a fresh URL if it expires.

originalFileNamestring required

The file name as it was on the uploader's device. Shown to users in the UI. May contain characters that are unsafe for object-storage keys, which is why it is never used as a storage identifier.

mimeTypestring required

MIME type as recorded at upload time — use this for the Content-Type response header when serving the download to the end user.

Example response

{
  "url": "https://example-bucket.s3.eu-central-1.amazonaws.com/consultationInformation/furunculotic-loud-chihuahua/uploadedFiles/a1b2c3d4-e5f6-7890-abcd-ef1234567890/8f1c4a60-7e3b-4b6f-9a9d-6d9f3c8b2e4a?X-Amz-Expires=3600&X-Amz-Signature=...",
  "originalFileName": "xray_bella_2024-06-12.pdf",
  "mimeType": "application/pdf"
}

Changes

No recorded changes to this operation across all 1 revision of this API.