Cambiamenti chiave nell’API di Etsy v3 e come incidono su venditori e sviluppatori:<\/span><\/h1>\n\n- \n
Sicurezza avanzata con OAuth 2.0:<\/b><\/h2>\n<\/li>\n<\/ol>\n
Uno dei cambiamenti importanti nell’API di Etsy v3 \u00e8 l’adozione di OAuth 2.0 per l’autenticazione e l’autorizzazione. OAuth 2.0 \u00e8 uno standard di settore pi\u00f9 sicuro e ampiamente utilizzato. Garantisce che solo le applicazioni autorizzate possano accedere ai dati del venditore ed eseguire azioni per loro conto.\ufffd<\/span><\/p>\n\u00ef \u00bf\u00bd<\/span><\/p>\n\n- <\/b>
\nRichieste di endpoint pi\u00f9 chiare:\ufffd<\/b><\/h2>\n<\/li>\n<\/ol>\n
L’API di Etsy v3 introduce modifiche al modo in cui gli sviluppatori inviano richieste all’API. Con la nuova versione, ogni richiesta deve includere un’intestazione “x-API-key” contenente la chiave API dell’app Etsy. Questa modifica migliora la sicurezza e aiuta Etsy a tenere traccia delle richieste API in modo pi\u00f9 efficace. I venditori e gli sviluppatori devono aggiornare il loro codice per includere questa intestazione quando comunicano con l’API di Etsy.<\/span><\/p>\n\u00ef \u00bf\u00bd<\/span><\/p>\n\n- <\/b>
\nParametri di richiesta standard:<\/b><\/h2>\n<\/li>\n<\/ol>\n
La gestione dei parametri di richiesta standard \u00e8 stata modificata. Il parametro di query “fields”, utilizzato in precedenza per recuperare risorse parziali nella v2, non \u00e8 pi\u00f9 supportato nella v3.<\/span>
\n<\/span>Sebbene il parametro di query “include” sia ancora disponibile in alcuni endpoint, il suo supporto \u00e8 limitato. In particolare, alcuni endpoint ora restituiscono i dati delle risorse associate per impostazione predefinita, semplificando la chiamata API.<\/span><\/p>\n\u00ef \u00bf\u00bd<\/span><\/p>\n\n- \n
Impaginazione:<\/b><\/h2>\n<\/li>\n<\/ol>\n
Gli utenti possono ora sperimentare l’impaginazione aggiornata. I parametri di query “limit” e “offset” devono essere utilizzati per l’impaginazione anzich\u00e9 il parametro “page” utilizzato in v2. I record predefiniti restituiti per chiamata API sono 25 e il numero massimo di record che possono essere restituiti \u00e8 100. Per facilitare la navigazione attraverso set di dati pi\u00f9 grandi, Etsy fornisce parametri di limite e offset. Il parametro limite consente di specificare il numero di record da recuperare per pagina. Mentre il parametro offset ti aiuta a navigare verso una pagina specifica di risultati.<\/span><\/p>\nInoltre, la risposta include un campo di conteggio, che indica il numero totale di record disponibili per l’impaginazione. Si noti che per motivi di prestazioni, il parametro offset ha un valore massimo di 50000, garantendo una gestione efficiente di set di dati di grandi dimensioni.<\/span><\/p>\n\u00ef \u00bf\u00bd![\"Ambiti](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2023\/06\/Resource-scopes.png\")
<\/a><\/span><\/p>\n <\/p>\n
\n- \n
Ambiti delle risorse:<\/b><\/h2>\n<\/li>\n<\/ol>\n
Nell’API di Etsy aggiornata v3, gli ambiti delle risorse per filtrare gli elenchi di risorse sono passati da filtri basati sul percorso a filtri basati su parametri di query.<\/span><\/p>\nEsempio: filtraggio delle inserzioni per ID negozio e stato<\/span><\/p>\nSupponi di voler filtrare le inserzioni in base a uno specifico ID negozio e stato. Nella v2, useresti:<\/span><\/p>\n\/v2\/shops\/:shop_id\/listings\/active<\/span><\/p>\nCon il passaggio alla versione 3, l’approccio del parametro URL e query sarebbe:<\/span><\/p>\n\/v3\/application\/listings?shop_id=:shop_id&state=attivo<\/span><\/p>\nQui includi i valori desiderati per l’ID negozio e lo stato come parametri di ricerca.<\/span><\/p>\n\u00ef \u00bf\u00bd<\/span><\/p>\n\n- \n
Struttura di risposta migliorata:<\/b><\/h2>\n<\/li>\n<\/ol>\n
Nella precedente versione del <\/span>API di Etsy (v2)<\/span><\/a>, le risposte API hanno seguito una struttura standardizzata. Incapsulamento di vari campi e oggetti nidificati. Tuttavia, nell’API di Etsy v3, le risposte sono cambiate. Nello specifico, gli endpoint che restituiscono elenchi di risorse ora includono due campi importanti: “count” e “results”.<\/span><\/p>\nIl campo “count” indica il numero di risultati nella risposta, fornendo una rapida panoramica del conteggio totale delle risorse restituite. D’altra parte, il campo “risultati” contiene gli stessi oggetti risorsa. Questa struttura rivista consente agli sviluppatori di accedere facilmente al conteggio e recuperare i risultati specifici dalla risposta.<\/span><\/p>\n\u00ef \u00bf\u00bd<\/span><\/p>\n\n- <\/b>
\nRitiro di risorse obsolete:<\/b><\/h2>\n<\/li>\n<\/ol>\n
Oltre 40+ risorse ed endpoint sono stati sostituiti o rimossi in v3 in varie categorie come Pagamento. ShopListingVariationImage, ShippingProfileUpgrade, User, ShopSection e altro. L’elenco completo delle risorse ritirate \u00e8 disponibile nella documentazione.>>https:\/\/developers.etsy.com\/documentation\/migration\/retired-resources\/<\/span><\/p>\n <\/p>\n
\n- \n
Limiti velocit\u00e0 API:<\/b><\/h2>\n<\/li>\n<\/ol>\n
![\"Il](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2023\/06\/API-Rate-Limits.png\")
<\/a><\/p>\n <\/p>\n
Nell’API di Etsy v3, non sono state apportate modifiche ai limiti di velocit\u00e0 dell’API rispetto alla v2. Se utilizzavi la stessa chiave API dell’app Etsy nella versione 2, i tuoi limiti tariffari negoziati rimarranno gli stessi anche nella versione 3.<\/span><\/p>\nPer impostazione predefinita, le app Etsy autenticate con la loro chiave API possono effettuare fino a 10,000 richieste pubbliche in un periodo di 24 ore, offrendo agli sviluppatori ampie opportunit\u00e0 di interagire con la piattaforma Etsy e recuperare i dati necessari per le loro applicazioni. Il limite di velocit\u00e0 (10 query al secondo) garantisce un utilizzo corretto e mantiene la stabilit\u00e0 del sistema.<\/span><\/p>\n\u00ef \u00bf\u00bd<\/span><\/p>\nLo sai?<\/b><\/h2>\n
Hai gi\u00e0 un negozio di eCommerce basato su Prestashop, Opencart, WooComemrce o Magento 2? Sai che con il connettore del marketplace di Knowband Etsy puoi elencare e gestire i tuoi prodotti sul marketplace di Etsy?<\/span>
\n<\/span> Il connettore Knowband Etsy Marketplace viene fornito con le ultime modifiche all’API Etsy V3 e garantisce una perfetta integrazione tra il tuo sito Web e il marketplace Etsy.<\/span>
\n<\/span> Ad esempio, puoi gestire tutti i tuoi ordini e le inserzioni Etsy direttamente dal pannello di amministrazione del tuo negozio di e-commerce. Inoltre, puoi anche contattarci all’indirizzo <\/span>support@knowband.com<\/span><\/a> per ulteriori informazioni su Etsy Marketplace Connector.\ufffd<\/span><\/p>\n
Sicurezza avanzata con OAuth 2.0:<\/b><\/h2>\n<\/li>\n<\/ol>\n
Uno dei cambiamenti importanti nell’API di Etsy v3 \u00e8 l’adozione di OAuth 2.0 per l’autenticazione e l’autorizzazione. OAuth 2.0 \u00e8 uno standard di settore pi\u00f9 sicuro e ampiamente utilizzato. Garantisce che solo le applicazioni autorizzate possano accedere ai dati del venditore ed eseguire azioni per loro conto.\ufffd<\/span><\/p>\n \u00ef \u00bf\u00bd<\/span><\/p>\n L’API di Etsy v3 introduce modifiche al modo in cui gli sviluppatori inviano richieste all’API. Con la nuova versione, ogni richiesta deve includere un’intestazione “x-API-key” contenente la chiave API dell’app Etsy. Questa modifica migliora la sicurezza e aiuta Etsy a tenere traccia delle richieste API in modo pi\u00f9 efficace. I venditori e gli sviluppatori devono aggiornare il loro codice per includere questa intestazione quando comunicano con l’API di Etsy.<\/span><\/p>\n \u00ef \u00bf\u00bd<\/span><\/p>\n La gestione dei parametri di richiesta standard \u00e8 stata modificata. Il parametro di query “fields”, utilizzato in precedenza per recuperare risorse parziali nella v2, non \u00e8 pi\u00f9 supportato nella v3.<\/span> \u00ef \u00bf\u00bd<\/span><\/p>\n Gli utenti possono ora sperimentare l’impaginazione aggiornata. I parametri di query “limit” e “offset” devono essere utilizzati per l’impaginazione anzich\u00e9 il parametro “page” utilizzato in v2. I record predefiniti restituiti per chiamata API sono 25 e il numero massimo di record che possono essere restituiti \u00e8 100. Per facilitare la navigazione attraverso set di dati pi\u00f9 grandi, Etsy fornisce parametri di limite e offset. Il parametro limite consente di specificare il numero di record da recuperare per pagina. Mentre il parametro offset ti aiuta a navigare verso una pagina specifica di risultati.<\/span><\/p>\n Inoltre, la risposta include un campo di conteggio, che indica il numero totale di record disponibili per l’impaginazione. Si noti che per motivi di prestazioni, il parametro offset ha un valore massimo di 50000, garantendo una gestione efficiente di set di dati di grandi dimensioni.<\/span><\/p>\n \u00ef \u00bf\u00bd <\/p>\n Nell’API di Etsy aggiornata v3, gli ambiti delle risorse per filtrare gli elenchi di risorse sono passati da filtri basati sul percorso a filtri basati su parametri di query.<\/span><\/p>\n Esempio: filtraggio delle inserzioni per ID negozio e stato<\/span><\/p>\n Supponi di voler filtrare le inserzioni in base a uno specifico ID negozio e stato. Nella v2, useresti:<\/span><\/p>\n \/v2\/shops\/:shop_id\/listings\/active<\/span><\/p>\n Con il passaggio alla versione 3, l’approccio del parametro URL e query sarebbe:<\/span><\/p>\n \/v3\/application\/listings?shop_id=:shop_id&state=attivo<\/span><\/p>\n Qui includi i valori desiderati per l’ID negozio e lo stato come parametri di ricerca.<\/span><\/p>\n \u00ef \u00bf\u00bd<\/span><\/p>\n Nella precedente versione del <\/span>API di Etsy (v2)<\/span><\/a>, le risposte API hanno seguito una struttura standardizzata. Incapsulamento di vari campi e oggetti nidificati. Tuttavia, nell’API di Etsy v3, le risposte sono cambiate. Nello specifico, gli endpoint che restituiscono elenchi di risorse ora includono due campi importanti: “count” e “results”.<\/span><\/p>\n Il campo “count” indica il numero di risultati nella risposta, fornendo una rapida panoramica del conteggio totale delle risorse restituite. D’altra parte, il campo “risultati” contiene gli stessi oggetti risorsa. Questa struttura rivista consente agli sviluppatori di accedere facilmente al conteggio e recuperare i risultati specifici dalla risposta.<\/span><\/p>\n \u00ef \u00bf\u00bd<\/span><\/p>\n Oltre 40+ risorse ed endpoint sono stati sostituiti o rimossi in v3 in varie categorie come Pagamento. ShopListingVariationImage, ShippingProfileUpgrade, User, ShopSection e altro. L’elenco completo delle risorse ritirate \u00e8 disponibile nella documentazione.>>https:\/\/developers.etsy.com\/documentation\/migration\/retired-resources\/<\/span><\/p>\n <\/p>\n <\/p>\n Nell’API di Etsy v3, non sono state apportate modifiche ai limiti di velocit\u00e0 dell’API rispetto alla v2. Se utilizzavi la stessa chiave API dell’app Etsy nella versione 2, i tuoi limiti tariffari negoziati rimarranno gli stessi anche nella versione 3.<\/span><\/p>\n Per impostazione predefinita, le app Etsy autenticate con la loro chiave API possono effettuare fino a 10,000 richieste pubbliche in un periodo di 24 ore, offrendo agli sviluppatori ampie opportunit\u00e0 di interagire con la piattaforma Etsy e recuperare i dati necessari per le loro applicazioni. Il limite di velocit\u00e0 (10 query al secondo) garantisce un utilizzo corretto e mantiene la stabilit\u00e0 del sistema.<\/span><\/p>\n \u00ef \u00bf\u00bd<\/span><\/p>\n Hai gi\u00e0 un negozio di eCommerce basato su Prestashop, Opencart, WooComemrce o Magento 2? Sai che con il connettore del marketplace di Knowband Etsy puoi elencare e gestire i tuoi prodotti sul marketplace di Etsy?<\/span>\n
\nRichieste di endpoint pi\u00f9 chiare:\ufffd<\/b><\/h2>\n<\/li>\n<\/ol>\n
\n
\nParametri di richiesta standard:<\/b><\/h2>\n<\/li>\n<\/ol>\n
\n<\/span>Sebbene il parametro di query “include” sia ancora disponibile in alcuni endpoint, il suo supporto \u00e8 limitato. In particolare, alcuni endpoint ora restituiscono i dati delle risorse associate per impostazione predefinita, semplificando la chiamata API.<\/span><\/p>\n\n
Impaginazione:<\/b><\/h2>\n<\/li>\n<\/ol>\n
<\/a><\/span><\/p>\n\n
Ambiti delle risorse:<\/b><\/h2>\n<\/li>\n<\/ol>\n
\n
Struttura di risposta migliorata:<\/b><\/h2>\n<\/li>\n<\/ol>\n
\n
\nRitiro di risorse obsolete:<\/b><\/h2>\n<\/li>\n<\/ol>\n
\n
Limiti velocit\u00e0 API:<\/b><\/h2>\n<\/li>\n<\/ol>\n
<\/a><\/p>\nLo sai?<\/b><\/h2>\n
\n<\/span> Il connettore Knowband Etsy Marketplace viene fornito con le ultime modifiche all’API Etsy V3 e garantisce una perfetta integrazione tra il tuo sito Web e il marketplace Etsy.<\/span>
\n<\/span> Ad esempio, puoi gestire tutti i tuoi ordini e le inserzioni Etsy direttamente dal pannello di amministrazione del tuo negozio di e-commerce. Inoltre, puoi anche contattarci all’indirizzo <\/span>support@knowband.com<\/span><\/a> per ulteriori informazioni su Etsy Marketplace Connector.\ufffd<\/span><\/p>\n