Changelog API

Aggiornamento v1 - luglio 2026

Aggiunte additive di codici di errore e campi di risposta al contratto v1 esistente.

• Nuovo errore 422 withdrawal_consent_required sull'endpoint download-urls degli ordini: viene restituito 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.
• Nuovo errore 422 key_limit_reached alla creazione di chiavi API: un negozio può detenere al massimo 25 chiavi API attive; revocane una prima.
• Nuovo errore 409 delivery_not_yet_released sugli endpoint download-urls e resend degli ordini: viene restituito quando il prodotto ha un ritardo di consegna del download configurato e i file dell'acquirente non sono ancora sbloccati. Finché il ritardo non è trascorso non viene emesso alcun URL di download né inviata alcuna email.
• Nuovo oggetto error.details nella busta di errore: presente solo sui codici che trasportano contesto sicuro per il chiamante. Oggi delivery_not_yet_released è l'unico a produrlo e contiene release_at, l'istante ISO 8601 in cui i download si sbloccano. Considera l'oggetto come aperto: possono comparire nuove chiavi senza un cambio di versione maggiore.
• Nuovi campi delivery_pending e release_at sull'oggetto acquisto dello stato ordine: delivery_pending è true finché un acquisto è ancora trattenuto da un ritardo di consegna del download, mentre release_at è l'istante ISO 8601 dello sblocco, oppure null quando non c'è nulla in sospeso.
• L'endpoint grant-downloads ora rilascia immediatamente gli acquisti trattenuti dell'ordine, così un commerciante può scavalcare un ritardo di consegna del download tramite l'API.

v1.0.0 - giugno 2026

Prima superficie API pilota dietro accesso solo su approvazione.

• API key per gli store approvati.
• Idempotency key obbligatorie sulle richieste di scrittura.
• Import di asset da URL remoto, upload diretti, elenco asset, aggiornamento asset ed eliminazione asset.
• Categorie piatte, mappature di prodotti, pack e tag per license key.
• Assegnazioni di ordini che rendono visibili i download mappati negli account cliente di Shopify.
• Controlli di accesso agli ordini: revoca, ripristino, concessione di download e reinvio dell'email.
• Endpoint per lo stato di job e ordini.
• Download della specifica OpenAPI e della collection Postman.

Politica di versioning

Il contratto v1 è solo additivo: possono essere aggiunti nuovi endpoint, campi facoltativi e nuovi codici di errore. Le modifiche incompatibili useranno un futuro percorso /api/v2.