logo

Important:

This API is designed for experienced developers only and is provided as a self-service tool with minimal support.

Please be aware that currently, this API only supports legacy checkouts and classic customer accounts. It does not support integration with New Customer Accounts & new Checkout Extensibility. Shopify has not yet enabled app integration capabilities for New Customer Accounts. It is anticipated that these Shopify features will become available later in 2024. See Shopify’s consideration guide.

Fileflare API

Visualizzazione dei prodotti

Utilizzare questa API per raccogliere tutti i prodotti e cercare prodotti/varianti per collegare/scollegare le attività.


Ricerca di prodotti

Per visualizzare i prodotti, inviare una richiesta GET a:

https://app.digital-downloads.com/api/v1/products

Per trovare i prodotti, è possibile aggiungere parametri di query string. I risultati sono paginati. Utilizzare il parametro stringa di query page per altre pagine, oppure utilizzare i link forniti nella risposta.

JSON
{
    "limit": 100, // max of 1000 will be retuned
    "name": "my new book", // searches name of product/vairant
    "sku": "my-sku",
    "product_id": 123456, // product_id that is generated by Shopify 
    "vendor": "my-store",
    "tag": "books",
    "page": 3,
    "with_assets": false // show linked assets
}

Risposta

JSON
{
    "data": [
        {
            "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/products?page=1",
        "last": "https://app.digital-downloads.com/api/v1/products?page=4",
        "prev": null,
        "next": "https://app.digital-downloads.com/api/v1/products?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/products?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": "https://app.digital-downloads.com/api/v1/products?page=2",
                "label": "2",
                "active": false
            },
            {
                "url": "https://app.digital-downloads.com/api/v1/products?page=3",
                "label": "3",
                "active": false
            },
            {
                "url": "https://app.digital-downloads.com/api/v1/products?page=4",
                "label": "4",
                "active": false
            },
            {
                "url": "https://app.digital-downloads.com/api/v1/products?page=2",
                "label": "Next »",
                "active": false
            }
        ],
        "path": "https://app.digital-downloads.com/api/v1/products",
        "per_page": 25,
        "to": 25,
        "total": 76
    }
}

Visualizza il prodotto

Per visualizzare un singolo prodotto, caricare facoltativamente gli asset collegati. Inviare una richiesta GET a:

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

Esempio

https://app.digital-downloads.com/api/v1/products/82664d96-6dfd-4343-96b0-05c46f412a5q?with_assets=true

Risposta

JSON
{
    "data": {
        "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"
        ],
        "assets": [
            {
                "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"
            }
        ]
    }
}