Return a list of Digital Assets - Spree Commerce Guides

API basics

Storefront API

Authentication
Account
Account / Address
Account / Credit Cards
Account / Orders
Order Status
Cart
Cart / Line Items
Cart / Other
Cart / Coupons
Checkout
Checkout / State
Checkout / Shipments
Checkout / Payments
Checkout / Store Credit
Products
Stores
Taxons
Countries
CMS Pages
Menus
Wishlists
Wishlists / Wished Items
Digital Downloads

Platform API

Authentication
Addresses
Adjustments
Classifications
CMS Pages
CMS Sections
Countries
Data Feeds
Digital Links
Digital Assets
- GET
  Return a list of Digital Assets
- POST
  Create a Digital Asset
- GET
  Return a Digital Asset
- DEL
  Delete a Digital Asset
- PATCH
  Update a Digital Asset
Line Items
Menu Items
Menus
Option Types
Option Values
Orders
Payment Methods
Payments
Products
Promotion Actions
Promotion Categories
Promotion Rules
Promotions
Roles
Shipments
Shipping Categories
Shipping Methods
States
Stock Items
Stock Locations
Store Credit Categories
Store Credit Types
Store Credits
Tax Categories
Tax Rates
Taxonomies
Taxons
Users
Variants
Webhook Events
Webhook Subscribers
Wished Items
Wishlists
Zones

GET

api

platform

digitals

curl --request GET \
  --url http://{defaultHost}/api/v2/platform/digitals \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "15",
      "type": "digital",
      "attributes": {
        "url": "/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBJQT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--fd5f8cec8849d4ccb3d1b3142c05292c54a61183/thinking-cat.jpg",
        "content_type": "image/jpeg",
        "filename": "thinking-cat.jpg",
        "byte_size": 18090
      },
      "relationships": {
        "variant": {
          "data": {
            "id": "80",
            "type": "variant"
          }
        }
      }
    },
    {
      "id": "16",
      "type": "digital",
      "attributes": {
        "url": "/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBJUT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a5cdd34bda2b6ab554834bbebc5eabfe55065258/thinking-cat.jpg",
        "content_type": "image/jpeg",
        "filename": "thinking-cat.jpg",
        "byte_size": 18090
      },
      "relationships": {
        "variant": {
          "data": {
            "id": "82",
            "type": "variant"
          }
        }
      }
    },
    {
      "id": "17",
      "type": "digital",
      "attributes": {
        "url": "/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBJZz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--86cfdf96a18ded007d9ec0ae05dd122cee26fef5/thinking-cat.jpg",
        "content_type": "image/jpeg",
        "filename": "thinking-cat.jpg",
        "byte_size": 18090
      },
      "relationships": {
        "variant": {
          "data": {
            "id": "84",
            "type": "variant"
          }
        }
      }
    }
  ],
  "meta": {
    "count": 3,
    "total_count": 3,
    "total_pages": 1
  },
  "links": {
    "self": "http://www.example.com/api/v2/platform/digitals?page=1&per_page=&include=",
    "next": "http://www.example.com/api/v2/platform/digitals?include=&page=1&per_page=",
    "prev": "http://www.example.com/api/v2/platform/digitals?include=&page=1&per_page=",
    "last": "http://www.example.com/api/v2/platform/digitals?include=&page=1&per_page=",
    "first": "http://www.example.com/api/v2/platform/digitals?include=&page=1&per_page="
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page

integer

per_page

integer

include

string

Select which associated resources you would like to fetch, see: <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>

Response

200

application/vnd.api+json

Records returned

data

object[]

required

meta

object

required

links

object

required

Was this page helpful?

Suggest edits Raise issue

Reset a Digital Link Create a Digital Asset

curl --request GET \
  --url http://{defaultHost}/api/v2/platform/digitals \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "15",
      "type": "digital",
      "attributes": {
        "url": "/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBJQT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--fd5f8cec8849d4ccb3d1b3142c05292c54a61183/thinking-cat.jpg",
        "content_type": "image/jpeg",
        "filename": "thinking-cat.jpg",
        "byte_size": 18090
      },
      "relationships": {
        "variant": {
          "data": {
            "id": "80",
            "type": "variant"
          }
        }
      }
    },
    {
      "id": "16",
      "type": "digital",
      "attributes": {
        "url": "/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBJUT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a5cdd34bda2b6ab554834bbebc5eabfe55065258/thinking-cat.jpg",
        "content_type": "image/jpeg",
        "filename": "thinking-cat.jpg",
        "byte_size": 18090
      },
      "relationships": {
        "variant": {
          "data": {
            "id": "82",
            "type": "variant"
          }
        }
      }
    },
    {
      "id": "17",
      "type": "digital",
      "attributes": {
        "url": "/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBJZz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--86cfdf96a18ded007d9ec0ae05dd122cee26fef5/thinking-cat.jpg",
        "content_type": "image/jpeg",
        "filename": "thinking-cat.jpg",
        "byte_size": 18090
      },
      "relationships": {
        "variant": {
          "data": {
            "id": "84",
            "type": "variant"
          }
        }
      }
    }
  ],
  "meta": {
    "count": 3,
    "total_count": 3,
    "total_pages": 1
  },
  "links": {
    "self": "http://www.example.com/api/v2/platform/digitals?page=1&per_page=&include=",
    "next": "http://www.example.com/api/v2/platform/digitals?include=&page=1&per_page=",
    "prev": "http://www.example.com/api/v2/platform/digitals?include=&page=1&per_page=",
    "last": "http://www.example.com/api/v2/platform/digitals?include=&page=1&per_page=",
    "first": "http://www.example.com/api/v2/platform/digitals?include=&page=1&per_page="
  }
}