✨ Únete a nuestro programa de afiliados

🔌 Referencia de la API

💡 Descubre la API de Dotb para Vinted

Dotb ofrece una API REST pública para que puedas automatizar tus flujos de trabajo de Dotb directamente desde tus propios scripts y herramientas.

La API está disponible con el plan Boutique AI.

Qué puedes hacer

Casi toda la API trabaja con tus datos en Dotb. Algunas llamadas actúan en Vinted en directo, a través de la extensión del navegador: consulta Llamadas que necesitan el bridge.

  • Crear anuncios en Dotb — crea tus anuncios a través de la API y luego publícalos en Vinted con la extensión del navegador.
  • Programar publicaciones — programa la publicación en Vinted de anuncios creados en Dotb y aún no publicados en Vinted (con al menos una foto), a las horas que elijas, con POST /items/schedule (hasta 250 por llamada). Quien publica es la extensión del navegador, así que debe estar en marcha (navegador abierto, extensión activa) tanto al programar como cuando se ejecuta la publicación; una vez en cola, la publicación programada espera y se reintenta cuando la extensión vuelve.
  • Consultar tus pedidos de Vinted — accede a los pedidos que Dotb ha sincronizado desde tu cuenta de Vinted.
  • Consultar tus clientes — lista los compradores de tus pedidos sincronizados, con su número de pedidos y el total gastado, y filtra los pedidos por cliente.
  • Recibir avisos con webhooks — registra hasta 3 URL HTTPS para recibir eventos (nuevo pedido, cambio de estado del pedido, reclamación abierta, publicación correcta o fallida, nueva notificación) como peticiones POST firmadas según el esquema Standard Webhooks. Gestiónalos desde Ajustes → Tokens de API o a través de la API. ¿Prefieres consultar periódicamente? El flujo GET /events devuelve los mismos eventos (se conservan 7 días).
  • Gestionar tus conversaciones de Vinted — lee conversaciones y mensajes, envía mensajes y haz o responde ofertas. Estas llamadas actúan directamente en Vinted a través de la extensión del navegador, así que debe estar en línea (navegador abierto, extensión activa) para esa cuenta de Vinted; si no, la API responde 503 al instante y no se pone nada en cola.
  • Leer tus notificaciones — lista las mismas notificaciones que la campana del panel (pedidos, agente inteligente, captchas, Vinted, Dotb), filtra por grupo, cuenta de Vinted o no leídas, consulta los contadores de no leídas y márcalas como leídas o no leídas (GET /notifications, /notifications/counts, /notifications/{id}, POST /notifications/{id}/read, /unread, /notifications/read-all). Los títulos y textos llegan en tu idioma, o indica locale. Los webhooks entregan cada nueva como notification.created.
  • Ver y eliminar tus artículos en línea — lista lo que hay ahora mismo en tu cuenta de Vinted (cada anuncio, borrador y artículo vendido, GET /accounts/{account_id}/live-items) y elimina anuncios, si quieres junto con su artículo de Dotb. Los artículos en línea son la versión corta que Vinted muestra en el armario; tus artículos de Dotb tienen los datos completos.
  • Seguir tus pedidos en línea y responder a reclamaciones — consulta un pedido de Vinted tal como está en Vinted ahora mismo (GET /accounts/{account_id}/live-orders/{transaction_id}, con el transaction_id de una conversación o el vinted_transaction_id de un pedido), mira la reclamación del comprador y respóndela: reembolso total, oferta de reembolso parcial o devolución. Tus pedidos de Dotb (/orders) son la copia sincronizada.

Llamadas que necesitan el bridge

En línea («live») significa leído y modificado en Vinted ahora mismo: artículos en línea, pedidos en línea y conversaciones en línea. Todo lo demás son tus datos en Dotb y funciona en cualquier momento. Las llamadas en línea, y algunas otras de abajo, pasan por el bridge de la extensión de Dotb. Para ellas, tu navegador debe estar abierto, con la extensión activa y el bridge activado para esa cuenta de Vinted:

  • Artículos en línea — listarlos y eliminarlos (/accounts/{account_id}/live-items).
  • Pedidos en línea y sus reclamaciones — todas las llamadas /accounts/{account_id}/live-orders/….
  • Conversaciones en línea — todas las llamadas /accounts/{account_id}/live-conversations/…. Subir una foto para un mensaje (POST /conversation-photos) no lo necesita.
  • Etiquetas de envío — POST /orders/{id}/shipping-label.
  • Publicaciones programadas — el bridge debe estar activo al programar. La publicación en sí espera a la extensión si se desconecta después.

Si el bridge está desactivado, estas llamadas fallan al instante y no se pone nada en cola (salvo las publicaciones programadas ya aceptadas). Para comprobarlo antes, GET /accounts devuelve bridge.connected para cada cuenta de Vinted.

🔌 Cómo activar el bridge

Documentación interactiva

La referencia completa de la API es pública e interactiva. Puedes explorar cada endpoint, inspeccionar los esquemas de solicitud y respuesta, y probar las llamadas directamente desde tu navegador.

📖 Abrir la referencia interactiva de la API

Autenticación

Cada solicitud se autentica con un token de API personal, enviado como token Bearer en la cabecera Authorization. Se requiere una suscripción Boutique AI.

Crea y gestiona tus tokens desde los ajustes de tokens de API. Trátalos como contraseñas: cualquier persona con un token puede actuar en tu nombre.

URL base

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

Para herramientas de IA y generadores de código

Hay disponible un resumen de la API legible por máquina en /api/public/v1/llms.txt, y la especificación OpenAPI sin procesar en /api/public/v1/openapi.json.