Introduzione alle Core APIs
Le Core APIs rappresentano il motore infrastrutturale di Webround. A differenza dei moduli orientati alla vendita, le Core APIs sono progettate per gestire il ciclo di vita dei tuoi progetti (Drafts) e la gestione fisica delle risorse statiche che compongono il tuo store.
Queste API sono lo strumento principale per la creazione di nuovi negozi e, soprattutto, per l'orchestrazione degli asset multimediali (immagini e video) caricati direttamente sulla nostra infrastruttura.
Gestione Asset: Core vs Commerce APIs
In Webround, la gestione degli asset può avvenire attraverso due canali, ma è fondamentale comprendere quale utilizzare in base alla provenienza del file.
1. Core APIs: Gestione dello Storage Nativo
Utilizza le Core APIs quando hai la necessità di caricare un file fisico (immagine o video) direttamente su Webround.
- Caricamento: Il file viene trasferito nel tuo Cloud Storage privato associato al Draft/Store.
- Storage Sync: Ogni byte caricato viene conteggiato nel tuo piano tariffario. Le Core APIs assicurano che il conteggio dello storage utilizzato sia sempre sincronizzato.
- Cancellazione Fisica: Eliminando un asset tramite le Core APIs, il sistema non si limita a rimuovere il riferimento nel database, ma elimina fisicamente il file dai nostri server di storage. Questo garantisce che lo spazio occupato venga liberato immediatamente ai fini del tuo abbonamento.
2. Commerce APIs: Gestione Riferimenti Esterni
Utilizza le Commerce APIs se preferisci ospitare i tuoi file su una CDN esterna (per esempio su un tuo bucket S3 o un server proprietario) e vuoi solo passare a Webround l'URL della risorsa.
- Nessun Upload: Webround memorizza solo il link (URL).
- Cancellazione Logica: Se cancelli una risorsa tramite le Commerce APIs, rimuoverai solo il riferimento nel database di Webround. Il file originale sulla tua CDN rimarrà intatto.
Se utilizzi le Commerce APIs per eliminare un file che avevi originariamente caricato tramite le Core APIs (quindi residente nei nostri server), il riferimento nel database verrà rimosso, ma il file fisico potrebbe restare orfano nello storage, continuando a occupare spazio nel tuo piano senza che tu possa più vederlo nel pannello.
Regola d'oro: Se il file è ospitato da Webround, usa sempre le Core APIs per gestirne l'eliminazione.
Performance e Caching
Webround utilizza una rete di distribuzione globale per garantire che le tue immagini e i tuoi video siano fulminei ovunque si trovi il tuo cliente.
A causa dei meccanismi di caching sui file statici, quando elimini un asset (tramite Core APIs), la risorsa viene rimossa istantaneamente dai nostri server di origine. Tuttavia, una copia del file potrebbe restare visibile tramite URL pubblico per un breve periodo di tempo nelle cache periferiche della CDN. Non aspettarti che il file sparisca globalmente al millesimo di secondo dalla richiesta di eliminazione.
Autenticazione e Sicurezza
Le Core APIs sono operazioni ad alto privilegio che agiscono direttamente sulla struttura del tuo business.
- Autenticazione: Richiedono un JWT Merchant (Bearer Token) valido.