Asset
| Metodo | Percorso | Scopo |
|---|
| POST | /assets | Importare un URL remoto come asset. |
| POST | /assets/uploads | Avviare un caricamento diretto. |
| POST | /assets/uploads/{uploadId}/complete | Completare un caricamento diretto. |
| GET | /assets | Elencare gli asset. |
| GET/PATCH/DELETE | /assets/{id} | Leggere, aggiornare o eliminare un asset. |
Categorie, mappature, pack, link e tag
| Metodo | Percorso | Scopo |
|---|
| GET/POST | /categories | Elencare o creare categorie piatte. |
| GET/PATCH/DELETE | /categories/{id} | Leggere, rinominare o eliminare una categoria. |
| GET/POST | /mappings | Elencare o inserire/aggiornare le mappature dei prodotti Shopify. |
| GET/PUT/DELETE | /mappings/{id} | Leggere, sostituire o eliminare una mappatura. |
| GET/POST | /packs | Elencare o creare pack. |
| GET/DELETE | /packs/{id} | Leggere o eliminare un pack. |
| GET/POST | /links | Elencare o creare link. La creazione richiede un piano a pagamento; limiti di visite e scadenza restano riservati all'admin. |
| GET/POST | /license-key-tags | Elencare o creare tag di chiavi di licenza. |
Ordini e accesso
| Metodo | Percorso | Scopo |
|---|
| GET | /orders/{shopify_order_id} | Leggere lo stato di download di un ordine. |
| GET/POST | /orders/{shopify_order_id}/assignments | Elencare o creare assegnazioni a livello di prodotto. |
| GET | /orders/{shopify_order_id}/assignments/{purchaseId}/download-urls | Generare URL di download. |
| POST | /orders/{shopify_order_id}/revoke | Disattivare l'accesso. |
| POST | /orders/{shopify_order_id}/restore | Ripristinare l'accesso. |
| POST | /orders/{shopify_order_id}/grant-downloads | Concedere download aggiuntivi. |
| POST | /orders/{shopify_order_id}/resend | Reinviare l'email di consegna. |
L'endpoint download-urls restituisce 422 withdrawal_consent_required quando il negozio ha attivato il consenso al diritto di recesso UE e l'ordine non ha ancora un record di consenso; gli URL di download vengono emessi non appena il cliente acconsente.
Gli endpoint download-urls e resend restituiscono 409 delivery_not_yet_released quando il prodotto ha un ritardo di consegna del download configurato e i file dell'acquirente non sono ancora sbloccati. Il valore error.details.release_at è l'istante ISO 8601 dello sblocco e l'endpoint grant-downloads rilascia l'ordine in anticipo.
Salute e stato
| Metodo | Percorso | Scopo |
|---|
| GET | /health | Verificare la disponibilità delle API. |
| GET | /ping | Verificare l'autenticazione. |
| GET | /jobs/{jobId} | Leggere lo stato di un job asincrono. |
Ultimo aggiornamento 2026-06-05