Lingua:

Come ottenere e utilizzare la chiave API di Etsy

Se vuoi ottenere e recuperare le tue inserzioni Etsy, mostrare le recensioni del tuo negozio sul sito o semplificare la gestione dei dati sulle transazioni, considera l’utilizzo di Etsy API. In questo articolo troverai utili consigli su come ottenere e utilizzare la chiave API, nonché esempi di Etsy API.
Scopri cosa ne pensa ChatGPT Apri l’editor del widget in tempo reale
How to get and use Etsy API key

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.

    Etsy developer registration
    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.

    Verify Etsy developer account

    Segui il link e verrai reindirizzato alla pagina dei parametri di sicurezza.

    Etsy Two-factor authentification

    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.

    Etsy Authenticator app

    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.

    Etsy SMS and phone authentication
  • 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.

    Create Etsy API app

    Completa il captcha e premi Leggi i Termini e Crea l’App.

    Create Etsy Application

    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.

    Etsy Developer Terms and Conditions
  • Passo 4 – Ottieni le credenziali API

    Dopo aver accettato i termini e le condizioni, otterrai l’accesso alla tua chiave API e al segreto.

    Etsy API Key
    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 metodofindAllFeedbackFromBuyers
SinossiRestituisce un insieme di oggetti Feedback associati a un utente. In sostanza, è l’unione tra i metodi findAllUserFeedbackAsBuyer e findAllUserFeedbackAsSubject.
Metodo HTTPGET
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.

Entrambi dispongono di metodi per trovare e recuperare pagamenti e transazioni legate a un negozio, un’inserzione, un acquirente, una ricevuta, ecc.

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.

Articolo di
Responsabile Marketing
Sono Andrei Kozinskiy, Marketing Lead presso Elfsight. Mi occupo della crescita degli utenti attraverso contenuti e diversi canali di traffico. Amo condividere intuizioni ed esperienze per aiutare gli altri a avere successo.