Cos’è l’API di Etsy?
Etsy offre un’API pubblica per ottenere e aggiornare i dati dalla piattaforma. Qualsiasi API permette agli sviluppatori di creare app basate su dati unici e funzionalità di un programma o sito web. Allo stesso modo, gli sviluppatori usano l’API di Etsy 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 o sforzo. Prima di tutto devi accedere al sito della community degli sviluppatori Etsy, dove puoi iniziare a creare le tue applicazioni e integrazioni usando la tua chiave API unica. Segui questo tutorial sull’API di Etsy per scoprire come accedere a questa interfaccia di programmazione.
- Passo 1 – Crea un account
Vai al sito della Community degli sviluppatori Etsy e registrati con un nuovo account oppure accedi con uno esistente.
Puoi registrarti usando il tuo indirizzo email oppure continuare con il tuo account Google, Facebook o Apple. - Passo 2 – Configura le impostazioni di sicurezza
Prima di creare la tua prima applicazione, il servizio richiede di impostare l’autenticazione a due fattori.
Segui il link e verrai reindirizzato alla pagina dei parametri di sicurezza.
Puoi scegliere tra diverse opzioni: installare l’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 verrà chiesto 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 scegli 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 selezionata.
- Passo 3 – Crea un’applicazione
Dopo aver configurato i requisiti di sicurezza, puoi iniziare a creare la tua prima applicazione. Per prima cosa devi compilare il modulo per descrivere la tua futura applicazione.
Completa il Captcha e clicca su Leggi Termini e Crea App.
Ti verrà chiesto di leggere i Termini e Condizioni dell’API di Etsy in un popup. Leggi attentamente il documento per conoscere i requisiti e le limitazioni nell’uso dell’interfaccia di programmazione. Spunta la casella e premi Crea App.
- Passo 4 – Ottieni le credenziali API
Dopo aver accettato i termini e condizioni, otterrai la tua chiave API e il segreto.
Ricorda di mantenere segrete le tue credenziali API e di non mostrarle né inviarle a terzi.
Come usare l’API di Etsy
Quando crei un’app per la prima volta, ha un Accesso Provvisorio predefinito ai servizi Etsy durante lo sviluppo. L’Accesso Provvisorio include le seguenti funzioni:
- Accesso in sola lettura a qualsiasi risorsa aperta e non autenticata, come Negozi e Tesori.
- Accesso autenticato (lettura e scrittura) ai dati appartenenti al proprietario dell’applicazione. Questo accesso permette di leggere dati personali come Ricevute e Fatturazione, e anche di creare, modificare o eliminare Inserzioni di un negozio. Se necessario, puoi richiedere l’accesso per un piccolo gruppo di utenti di test oltre al proprietario dell’app.
Etsy offre anche l’Accesso Completo, che consente l’accesso autenticato a dati illimitati dei membri Etsy. Se l’integrazione che stai sviluppando non richiede privilegi così estesi, puoi usare l’app in modalità provvisoria.
Se desideri comunque avere l’accesso completo per la tua applicazione, devi prima usare l’Accesso Provvisorio per sviluppare l’app e farla funzionare correttamente, quindi verificare se soddisfi i requisiti della piattaforma per l’Accesso Completo.
Esempi di API di Etsy
API recensioni di Etsy
La piattaforma Etsy dispone di un sistema di Feedback che permette a compratori e venditori di lasciare recensioni reciproche su specifiche transazioni. Offre diversi metodi per trovare tipi specifici di feedback disponibili sulla piattaforma. Ad esempio, findAllUserFeedbackAsAuthor, findAllUserFeedbackAsBuyer, findAllUserFeedbackAsSeller, e molti altri.
Ecco un esempio del metodo findAllFeedbackFromBuyers, che ti permette di ottenere e utilizzare i feedback dei tuoi clienti.
| Nome Metodo | findAllFeedbackFromBuyers |
| Descrizione | Restituisce un insieme di oggetti Feedback associati a un Utente. È essenzialmente l’unione tra i metodi findAllUserFeedbackAsBuyer e findAllUserFeedbackAsSubject. |
| Metodo HTTP | GET |
| URI | /users/:user_id/feedback/from-buyers |
Se cerchi un modo per mostrare le recensioni dei clienti dal tuo negozio Etsy, prova un widget Recensioni già pronto!
API pagamenti di Etsy
L’API Pagamenti e Transazioni fanno parte degli Strumenti per Venditori di Etsy. Tutte le vendite e gli acquisti effettuati tramite la piattaforma Etsy sono suddivisi in 3 fonti principali: Ordini, Ricevute e Transazioni. L’API Pagamenti rappresenta un pagamento effettuato con Etsy Payments.
API inserzioni di Etsy
Le inserzioni di Etsy sono gli articoli disponibili in vendita. Ogni inserzione è collegata a un Utente e a un Negozio (l’utente proprietario del negozio). Le inserzioni hanno prezzo e quantità associati e, quando sono esaurite, il proprietario deve rinnovarle prima di poterle vendere di nuovo. Sono disponibili metodi per trovare e recuperare inserzioni di varie categorie, oltre che per crearle ed eliminarle. Queste categorie includono: Attive, Interessanti, di Tendenza, Ricevute e altre. L’API Inserzioni di Etsy può ottenere gli articoli del venditore con il metodo findAllShopListingsActive, che trova tutte le inserzioni attive di un negozio.
Documentazione API di Etsy
Il sito della community degli sviluppatori Etsy offre una sezione Documentazione ben sviluppata per i suoi membri. C’è una Guida base per chi è nuovo all’interfaccia di programmazione Etsy, per aiutarlo a iniziare. Una sezione unica del portale API di Etsy è la Sezione Discussioni. Chiunque può partecipare per chiedere aiuto e condividere esperienze e casi.
FAQ
Etsy ha un’API?
Sì, Etsy offre una vasta gamma di soluzioni per sviluppatori, divise in 2 categorie principali: strumenti per venditori e per acquirenti. L’accesso all’API web di Etsy è gratuito e aperto a tutti.
Come trovo l’ID della mia inserzione Etsy?
Ogni inserzione su Etsy ha un numero identificativo unico. Puoi trovarlo nell’URL dell’inserzione. Navigando un’inserzione Etsy, l’ID è disponibile alla fine dell’indirizzo web. Gli URL delle inserzioni hanno questo formato: www.etsy.com/listing/ID-inserzione/.
Cos’è la mia chiave API di Etsy?
Per usare l’API di Etsy serve una chiave applicativa unica fornita durante la registrazione dell’app. Questa chiave identifica l’applicazione sulla piattaforma Etsy e serve a monitorare i limiti di chiamata.
Dove trovo la mia API di Etsy?
Puoi trovare la tua chiave API unica per ogni app Etsy creata nel tuo account sviluppatore Etsy. Vai alla scheda App create e clicca sull’applicazione desiderata per vedere le sue credenziali. Se non hai un account sviluppatore o app creata, consulta la seconda sezione del nostro articolo sopra.
