LogoLogo
System Status
2021-12-13
2021-12-13
  • 2021-12-13
  • Charges
    • Charge basics
  • Checkouts
  • Country specifications
  • Customers
  • Events
  • Fees
  • File Links
    • File link basics
  • Files
    • File basics
  • Fulfillments
  • Fulfillment cancellations
  • Fulfillment orders
  • Fulfillment returns
  • Inventory items
  • Inventory levels
  • Invoices
    • Invoice basics
  • Logistics returns
  • Orders
    • Order basics
  • Payouts
  • Plans
    • Plan basics
  • Refunds
  • Reservations
  • Returns
  • Sales summaries
  • Sales transactions
  • Shipments
  • Shipping labels
  • Shipping quotes
  • SKUs
  • SKU Groups
  • Sources
  • Subscriptions
    • Subscription basics
  • Tax identifiers
  • Webhooks
  • Drop-in checkout links
  • Drop-in checkout sessions
    • Checkout-sessions basics
  • Drop-in shipping quotes
  • Store credit callout
Powered by GitBook
On this page
  • Creating a file link
  • Setting the file links parameter
  • Creating a file link example
  1. File Links

File link basics

Learn more about the files resource.

PreviousFile LinksNextFiles

Last updated 2 months ago

You can create a file link when you want to share the contents of a object with a customer. If you want unauthenticated access to a file that a customer can download, you can create a link containing a URL pointing to the file and then send it to the customer.

Creating a file link

When you create a file link, we also update the associated file to include the file link's identifier. The file can have an array of file links showing the relationship between the file and file links, including the file link you just created.

Setting the file links parameter

When you create a File Link, you'll need to provide the required parameters listed in the following table. The remaining parameters are optional:

Parameter
Required/Optional
Description

fileId

Required

The file identifier.

expiresTime

Required

A future timestamp, after which the link will no longer be usable.

metadata

Optional

Additional structured information for the object.

Creating a file link example

Create a object with a POST request:

curl --location --request POST 'https://api.digitalriver.com/file-links' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API_key>' \
  "fileId": "49ca4603-a718-424b-8a5e-0bfa95f98ae8",
  "expiresTime": "2020-10-25T20:36:00Z"
}'

A 201 Created response returns a File Link object:

{
    "id": "e8a63964-9a92-4c71-bc28-332681d8c815",
    "createdTime": "2020-08-10T13:08:33.389Z",
    "expired": false,
    "expiresTime": "2020-10-25T20:36:00Z",
    "fileId": "49ca4603-a718-424b-8a5e-0bfa95f98ae8",
    "url": "https://files-test.digitalriver.com/links/e8a63964-9a92-4c71-bc28-332681d8c815",
    "liveMode": false
}
File
File Link