Downloads

Download a link someone shared with you

Pass a transfer (/t/…) or collection (/c/…) link and get what a person opening it in a browser could download, as signed URLs. The same rules as the page apply: passwords go through the same attempt budgets, one call counts as one download of the transfer, a download limit is enforced, and a collection shared with invited guests only is refused. Any key may call it, including a free one.

post/links/resolve

Request

  • Base URL: https://yungle.co/api/v1
  • URL: https://yungle.co/api/v1/links/resolve
  • Auth: HTTP bearer

Request body

urlstring required

A Yungle share link: https://yungle.co/t/… (a transfer) or https://yungle.co/c/… (a collection).

passwordstring

For a password-protected link.

Response

Signed download URLs.

kindstring required

Currently one of: transfer, collection. Treat unknown values as unknown, not as an error.

titlestring nullable required

A collection's title, or your own transfer's title when you ask for its links. Null when resolving a transfer link someone shared with you: a transfer's title is never shown to recipients.

messagestring nullable required

The sender's note on a transfer.

expiresAtstring date-time nullable required

When the transfer or collection itself expires. Null for one that keeps things forever.

e2eeboolean required

End-to-end encrypted: the bytes are ciphertext, and the key is in the # part of the link.

e2eeMetastring nullable
completeboolean required

False while a transfer is still uploading. files lists what has arrived so far; ask again later.

zipUrlstring uri nullable required

Everything in one ZIP (resumable with Range). Null for a single file, or while incomplete.

urlsExpireAtstring date-time required

When the signed URLs stop working. Ask again for fresh ones.

filesDownloadLink[] required(unresolved $ref)

Changes

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