Signed URL Response

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/usps/json-schema/usps-signed-urlresponse-schema.json",
  "title": "Signed URL Response",
  "description": "Response containing a signed URL and metadata for downloading a location file.",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/usps-locations-openapi.yml#/components/schemas/SignedURLResponse",
  "type": "object",
  "properties": {
    "signedURL": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1,
      "description": "A fully-qualified SAS URL appended with a secure token that provides temporary, restricted access to the requested location file. This SAS URL supports HTTP Range requests, allowing consumers to download files in chunks. This is particularly useful for resuming interrupted downloads or handling very large files.\n"
    },
    "expiry": {
      "type": "string",
      "format": "date-time",
      "maxLength": 35,
      "minLength": 1,
      "description": "Expiration date and time of the signed URL."
    },
    "contentLength": {
      "type": "integer",
      "minimum": 0,
      "maximum": 107374182400,
      "description": "Size of the file in bytes."
    },
    "rangeLimit": {
      "type": "integer",
      "minimum": 0,
      "maximum": 107374182400,
      "description": "The maximum number of bytes that can be downloaded using the signed URL. This value is specified in bytes and ensures that users do not exceed the allocated download limit."
    }
  },
  "additionalProperties": false
}