Skip to content
Navigation

Answers the bytes of a private file a capability names, to the bearer that asked for it.

The URL POST /assets/{asset}/url answers for a private file, or a download. Fetch it with the same bearer, before it is refreshed.

GET
https://api.sherpo.io/merchant/v1/stores/{store}/files/{capability}

Authorization

  • bearer
    HTTP
    required

Path parameters

  • store
    string
    required

    A store the token reaches; the file is served from the store its URL was minted for.

  • capability
    string
    required

    The capability in the URL POST /assets/{asset}/url answered: the path segment after /files/. A file name may follow it as another segment, never inside this one.

    minLength: 1

Header parameters

  • Range
    optional
    string

    One byte range of a file shown in place, bytes={first}-{last}, bytes={first}- or bytes=-{suffix}; a download is answered whole.

  • If-Range
    optional
    string

    The file's ETag from an earlier answer: the range is answered only while the file is unchanged, else the whole file.

Returns

200

The file's bytes, with its type and disposition.

206

The range asked for.

416

The range lies outside the file, or is other than one bytes range.
JSON
  • type
    string
    required
    format: uri
  • title
    string
    required
  • status
    integer
    required
  • detail
    string
    required
  • code
    optional
    string
  • context
    optional
    object
  • reached_core
    optional
    boolean
  • core_answer
    optional
    string
JSON
  • type
    string
    required
    format: uri
  • title
    string
    required
  • status
    integer
    required
  • detail
    string
    required
  • code
    optional
    string
  • context
    optional
    object
  • reached_core
    optional
    boolean
  • core_answer
    optional
    string

Type to search…

↑↓ navigate↵ selectEsc close