Viewing assets

Use this api to search for assets. Optionally view connected products too.

Search for assets

To view assets send a GET request to

GET https://app.digital-downloads.com/api/v1/assets

To find assets you can add query string parameters. The results are paginated use query string parameter page for more pages, or use the links provided in the response.

{
    "limit": 100, // max of 1000 will be retuned
    "filename": "My new book",
    "with_products": true, // show linked products
    "page": 5
}

Example

https://app.digital-downloads.com/api/v1/assets?limit10&filename=My%20new%20book&with_products=true&page=5

Response

{
    "data": [
        {
            "id": "82664d96-6dfd-4343-96b0-05c46f412a5b",
            "filename": "My new book",
            "size": "10MB",
            "is_file": false,
            "is_link": true,
            "url": "https://www.my-website.com/download/my-book.pdf",
            "products": [
                {
                    "id": "82664d96-6dfd-4343-96b0-05c46f412a5q",
                    "name": "My new Book",
                    "variant_name": "Paper back",
                    "sku": "my-sku",
                    "product_id": 123456,
                    "variant_id": 1234567,
                    "vendor": "my-store",
                    "tags": [
                        "books",
                        "paper-books"
                    ]
                },
                {
                    "id": "82664d96-6dfd-4343-96b0-05c46f412a5r",
                    "name": "My new Book",
                    "variant_name": "Hard back",
                    "sku": "my-sku",
                    "product_id": 123456,
                    "variant_id": 1234563,
                    "vendor": "my-store",
                    "tags": [
                        "books",
                        "hardback-books"
                    ]
                }
            ]
        }
    ],
    "links": {
        "first": "https://app.digital-downloads.com/api/v1/assets?page=1",
        "last": "https://app.digital-downloads.com/api/v1/assets?page=4",
        "prev": null,
        "next": "https://app.digital-downloads.com/api/v1/assets?page=2"
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 4,
        "links": [
            {
                "url": null,
                "label": "« Previous",
                "active": false
            },
            {
                "url": "https://app.digital-downloads.com/api/v1/assets?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": "https://app.digital-downloads.com/api/v1/assets?page=2",
                "label": "2",
                "active": false
            },
            {
                "url": "https://app.digital-downloads.com/api/v1/assets?page=3",
                "label": "3",
                "active": false
            },
            {
                "url": "https://app.digital-downloads.com/api/v1/assets?page=4",
                "label": "4",
                "active": false
            },
            {
                "url": "https://app.digital-downloads.com/api/v1/assets?page=2",
                "label": "Next »",
                "active": false
            }
        ],
        "path": "https://app.digital-downloads.com/api/v1/assets",
        "per_page": 25,
        "to": 25,
        "total": 76
    }
}

View asset

View individual asset, optionally load linked products. Send a GET request using the assets id

GET https://app.digital-downloads.com/api/v1/assets/:id

Example

https://app.digital-downloads.com/api/v1/assets/82664d96-6dfd-4343-96b0-05c46f412a5b?with_products=true

Response

{
    "data": {
        "id": "82664d96-6dfd-4343-96b0-05c46f412a5b",
        "filename": "My new book",
        "size": "10MB",
        "is_file": false,
        "is_link": true,
        "url": "https://www.my-website.com/download/my-book.pdf",
        "products": [
            {
                "id": "82664d96-6dfd-4343-96b0-05c46f412a5q",
                "name": "My new Book",
                "variant_name": "Paper back",
                "sku": "my-sku",
                "product_id": 123456,
                "variant_id": 1234567,
                "vendor": "my-store",
                "tags": [
                    "books",
                    "paper-books"
                ]
            },
            {
                "id": "82664d96-6dfd-4343-96b0-05c46f412a5r",
                "name": "My new Book",
                "variant_name": "Hard back",
                "sku": "my-sku",
                "product_id": 123456,
                "variant_id": 1234563,
                "vendor": "my-store",
                "tags": [
                    "books",
                    "hardback-books"
                ]
            }
        ]
    }
}