Cos’è l’Etsy API?
Etsy mette a disposizione una API pubblica per ottenere e aggiornare i dati della piattaforma. Qualsiasi API consente agli sviluppatori di creare app basate su dati unici e opzioni di un programma o di un sito. Allo stesso modo, gli sviluppatori usano Etsy API per creare integrazioni per venditori e acquirenti.
Come ottenere la chiave API di Etsy
Ottenere l’accesso all’API web di Etsy non richiede molto tempo né impegno. Per iniziare, accedi al sito della community degli sviluppatori Etsy, dove puoi creare le tue applicazioni e integrazioni usando la tua chiave API unica. Segui questa guida all’API Etsy qui sotto per scoprire come si accede a questa interfaccia di programmazione.
- Passo 1 – Crea un account
Vai al sito Etsy Developers Community e crea un nuovo account o accedi con quello esistente.
Puoi registrarti facilmente usando l’indirizzo email o continuare con il tuo account Google, Facebook o Apple. - Fase 2 – Impostazioni di sicurezza
Prima di creare la tua prima applicazione, il servizio richiede l’attivazione dell’autenticazione a due fattori.
Segui il link e verrai reindirizzato alla pagina dei parametri di sicurezza.
Puoi scegliere tra diverse opzioni: installare un’app Google Authenticator sul tuo dispositivo mobile per confermare l’accesso con un codice di conferma generato dall’app. Dopo aver selezionato questa opzione ti viene proposta la possibilità di scaricare l’app e collegarla al portale sviluppatori Etsy tramite la scansione di un codice QR.
Puoi anche scegliere la verifica tramite chiamata telefonica o SMS. Se selezioni questa opzione, devi inserire il tuo numero di telefono nel campo corrispondente. Dopo aver cliccato Avanti riceverai un codice SMS o una chiamata automatica, a seconda dell’opzione scelta.
- Fase 3 – Crea un’applicazione
Dopo aver adeguato i requisiti di sicurezza, puoi iniziare a creare la tua prima applicazione. Per prima cosa, compila il modulo per descrivere l’applicazione che intendi realizzare.
Completa il captcha e premi Leggi i Termini e Crea l’App.
Ti verrà chiesto di leggere i Termini e le Condizioni dell’Etsy API nel pop‑up. Familiarizza con il documento per conoscere requisiti e restrizioni durante l’uso dell’API. Spunta la casella e premi Crea App.
- Passo 4 – Ottieni le credenziali API
Dopo aver accettato i termini e le condizioni, otterrai l’accesso alla tua chiave API e al segreto.
Ricorda di tenere segrete le tue credenziali API e di non mostrarle né inviarle a terze parti.
Come utilizzare l’API Etsy
Quando crei per la prima volta un’app, questa dispone di Accesso Provvisorio predefinito ai servizi Etsy durante lo sviluppo. L’Accesso Provvisorio include le seguenti funzioni:
- Accesso in lettura a risorse aperte non autenticate, ad es. Negozi e Tesori.
- Accesso autenticato (lettura e scrittura) ai dati appartenenti al proprietario dell’applicazione. Questo accesso consente di leggere dati personali come Ricevute e Fatturazione, e anche creare, modificare o eliminare Inserzioni di un negozio. Se necessario, è possibile richiedere l’accesso per un piccolo gruppo di utenti di test oltre al proprietario dell’app.
Etsy offre anche l’Accesso completo, che permette l’accesso autenticato a dati illimitati dei membri di Etsy. Se l’integrazione che stai sviluppando non richiede tali privilegi, puoi utilizzare l’app in modalità provvisoria.
Se desideri ancora avere l’Accesso completo per la tua applicazione, dovresti innanzitutto utilizzare l’Accesso Provvisorio per sviluppare l’app e farla funzionare correttamente, quindi verificare se soddisfi i requisiti della piattaforma requisiti per l’Accesso completo.
Esempi dell’API Etsy
API Recensioni Etsy
La piattaforma Etsy mette a disposizione un sistema di feedback che permette ad acquirenti e venditori di lasciare feedback l’uno sull’altro riguardo a transazioni specifiche su Etsy. Dispone di diversi metodi per individuare tipologie specifiche di feedback disponibili sulla piattaforma. Sono, ad esempio, findAllUserFeedbackAsAuthor, findAllUserFeedbackAsBuyer, findAllUserFeedbackAsSeller, e molti altri.
Ecco un esempio del metodo findAllFeedbackFromBuyers, che ti permette di ottenere e utilizzare il feedback dai tuoi clienti.
| Nome del metodo | findAllFeedbackFromBuyers |
| Sinossi | Restituisce un insieme di oggetti Feedback associati a un utente. In sostanza, è l’unione tra i metodi findAllUserFeedbackAsBuyer e findAllUserFeedbackAsSubject. |
| Metodo HTTP | GET |
| URI | /users/:user_id/feedback/from-buyers |
Se vuoi trovare modi per mostrare le recensioni dei clienti dal tuo negozio Etsy, prova un widget Recensioni pronto all’uso Reviews Widget!
API di pagamento Etsy
L’API di Pagamento e API delle Transazioni fanno parte degli Strumenti per Venditori Etsy. Tutte le vendite e gli acquisti effettuati tramite la piattaforma Etsy sono suddivisi in tre fonti principali: Ordini, Ricevute e Transazioni. E API di Pagamento rappresenta un pagamento effettuato con Etsy Payments.
API per le inserzioni Etsy
Etsy Inserzioni sono articoli disponibili per la vendita. Ogni Inserzione è collegata a un Utente e a un Negozio (L’Utente che possiede questo Negozio). Le Inserzioni mostrano prezzo e quantità associati e, quando sono esaurite, il proprietario del negozio deve rinnovare gli articoli prima che possano essere venduti di nuovo. Presenta metodi per trovare e recuperare inserzioni di varie categorie, e anche per creare ed eliminare inserzioni. Queste categorie includono: Attive, Interessanti, In tendenza, Ricevute e altre Inserzioni. L’Etsy Listing API può ottenere articoli del venditore con il metodo findAllShopListingsActive, che trova tutte le Inserzioni attive appartenenti a un negozio.
Documentazione dell’Etsy API
Il sito della comunità degli sviluppatori Etsy mette a disposizione una Sezione Documentazione completa per i suoi membri. C’è una Guida alle Basi per chi è nuovo all’API di Etsy, pensata per aiutarli ad iniziare subito a usarla.
FAQ (Domande frequenti)
Etsy ha un’API?
Sì, Etsy offre una vasta gamma di soluzioni per sviluppatori, suddivise in due categorie principali: Strumenti per Venditori e Strumenti per Acquirenti. L’accesso all’Etsy Web API è gratuito per un vasto pubblico.
Come trovare l’ID della tua inserzione Etsy?
Ogni inserzione Etsy ha un numero identificativo univoco. Può essere trovato nell’URL dell’inserzione. Navigando tra le inserzioni Etsy, il suo ID è disponibile alla fine dell’indirizzo. Gli URL delle inserzioni hanno questo formato: www.etsy.com/listing/Listing ID/.
Qual è la mia chiave API Etsy?
L’uso dell’API Etsy richiede una chiave applicazione unica fornita durante la registrazione della tua app. Questa chiave API identifica l’applicazione sulla piattaforma web di Etsy e serve a monitorare i limiti di chiamata.
Dove trovare la mia API Etsy?
Puoi trovare la tua API unica per ogni app Etsy che hai creato nel tuo account sviluppatori Etsy. Vai alla scheda App create e fai clic sull’applicazione richiesta per vedere le sue credenziali. Se non hai un account da sviluppatore o un’applicazione creata, consulta la seconda sezione del nostro articolo sopra.











