✨ Unisciti al nostro programma di affiliazione

🔌 Riferimento API

💡 Scopri l'API di Dotb per Vinted

Dotb offre un'API REST pubblica che ti permette di automatizzare i tuoi flussi di lavoro Dotb direttamente dai tuoi script e strumenti.

L'API è disponibile con il piano Boutique AI.

Cosa puoi fare

Quasi tutta l'API lavora con i tuoi dati su Dotb. Alcune chiamate agiscono su Vinted in tempo reale, tramite l'estensione del browser: vedi Chiamate che richiedono il bridge.

  • Creare annunci su Dotb — crea i tuoi annunci tramite l'API, poi pubblicali su Vinted con l'estensione del browser.
  • Programmare le pubblicazioni — programma la pubblicazione su Vinted di annunci creati su Dotb e non ancora su Vinted (con almeno una foto), agli orari che scegli, con POST /items/schedule (fino a 250 per chiamata). A pubblicare è l'estensione del browser, quindi deve essere in funzione (browser aperto, estensione attiva) sia quando programmi sia quando la pubblicazione viene eseguita; una volta in coda, la pubblicazione programmata attende e viene ritentata quando l'estensione torna disponibile.
  • Consultare i tuoi ordini Vinted — accedi agli ordini che Dotb ha sincronizzato dal tuo account Vinted.
  • Ritrovare i tuoi clienti — elenca gli acquirenti dei tuoi ordini sincronizzati, con numero di ordini e totale speso, e filtra gli ordini per cliente.
  • Ricevere notifiche con i webhook — registra fino a 3 URL HTTPS per ricevere eventi (nuovo ordine, cambio di stato dell'ordine, reclamo aperto, pubblicazione riuscita o fallita, nuova notifica) come richieste POST firmate secondo lo schema Standard Webhooks. Gestiscili da Impostazioni → Token API o tramite l'API. Preferisci interrogare periodicamente? Il feed GET /events restituisce gli stessi eventi (conservati 7 giorni).
  • Gestire le tue conversazioni Vinted — leggi conversazioni e messaggi, invia messaggi e fai o rispondi a offerte. Queste chiamate agiscono direttamente su Vinted tramite l'estensione del browser, quindi deve essere online (browser aperto, estensione attiva) per quell'account Vinted; altrimenti l'API risponde subito 503 e non viene messo nulla in coda.
  • Leggere le tue notifiche — elenca le stesse notifiche della campanella della dashboard (ordini, agente intelligente, captcha, Vinted, Dotb), filtra per gruppo, account Vinted o non lette, ottieni i contatori delle non lette e segnale come lette o non lette (GET /notifications, /notifications/counts, /notifications/{id}, POST /notifications/{id}/read, /unread, /notifications/read-all). Titoli e testi arrivano nella tua lingua, oppure passa locale. I webhook consegnano ogni nuova notifica come notification.created.
  • Vedere ed eliminare i tuoi articoli online — elenca ciò che c'è ora sul tuo account Vinted (ogni annuncio, bozza e articolo venduto, GET /accounts/{account_id}/live-items) ed elimina annunci, se vuoi insieme al loro articolo Dotb. Gli articoli online sono la versione breve che Vinted mostra nel guardaroba; i tuoi articoli Dotb contengono i dati completi.
  • Seguire i tuoi ordini online e rispondere ai reclami — leggi un ordine Vinted così com'è su Vinted in questo momento (GET /accounts/{account_id}/live-orders/{transaction_id}, con il transaction_id di una conversazione o il vinted_transaction_id di un ordine), vedi il reclamo dell'acquirente e rispondi: rimborso totale, offerta di rimborso parziale o reso. I tuoi ordini Dotb (/orders) ne sono la copia sincronizzata.

Chiamate che richiedono il bridge

Online («live») significa letto e modificato su Vinted in questo momento: articoli online, ordini online e conversazioni online. Tutto il resto sono i tuoi dati su Dotb e funziona in qualsiasi momento. Le chiamate online, e alcune altre qui sotto, passano dal bridge dell'estensione Dotb. Per queste, il browser deve essere aperto, con l'estensione attiva e il bridge attivato per quell'account Vinted:

  • Articoli online — elencarli ed eliminarli (/accounts/{account_id}/live-items).
  • Ordini online e i loro reclami — tutte le chiamate /accounts/{account_id}/live-orders/….
  • Conversazioni online — tutte le chiamate /accounts/{account_id}/live-conversations/…. Caricare una foto per un messaggio (POST /conversation-photos) non lo richiede.
  • Etichette di spedizione — POST /orders/{id}/shipping-label.
  • Pubblicazioni programmate — il bridge deve essere attivo quando programmi. La pubblicazione stessa attende l'estensione se poi va offline.

Quando il bridge è disattivato, queste chiamate falliscono subito e nulla viene messo in coda (tranne le pubblicazioni programmate già accettate). Per verificarlo prima, GET /accounts restituisce bridge.connected per ogni account Vinted.

🔌 Come attivare il bridge

Documentazione interattiva

Il riferimento completo dell'API è pubblico e interattivo. Puoi esplorare ogni endpoint, ispezionare gli schemi di richiesta e risposta e provare le chiamate direttamente dal browser.

📖 Apri il riferimento interattivo dell'API

Autenticazione

Ogni richiesta è autenticata tramite un token API personale, inviato come token Bearer nell'intestazione Authorization. È richiesto un abbonamento Boutique AI.

Crea e gestisci i tuoi token dalle impostazioni dei token API. Trattali come password: chiunque abbia un token può agire per tuo conto.

URL di base

https://dotb.io/api/public/v1

Per strumenti di IA e generatori di codice

È disponibile un riepilogo dell'API leggibile dalle macchine all'indirizzo /api/public/v1/llms.txt, e la specifica OpenAPI grezza su /api/public/v1/openapi.json.