API da Vinted

Crie as suas próprias ferramentas para a Vinted com a API do Dotb e IA

Dê a descrição da API ao ChatGPT, ao Claude ou ao Cursor, descreva a ferramenta de que precisa e o seu assistente de IA pode escrever o código.

Instalar o Dotb Ler a documentação

Como funciona

  1. 1

    Crie um token de API

    No plano Boutique AI, crie um token pessoal nas definições de tokens de API.

  2. 2

    Dê a API à sua IA

    Partilhe o llms.txt ou a especificação OpenAPI com o seu assistente de IA.

  3. 3

    Descreva a ferramenta e execute-a

    Explique o que quer construir, deixe a IA ajudá-lo a escrever o código e execute-o com o seu token.

Crie anúncios através da API

Incluído no Boutique AI

Crie anúncios no Dotb a partir dos seus próprios scripts e ferramentas e depois publique-os na Vinted com a extensão do navegador. A API não comunica diretamente com a Vinted: trabalha com os seus dados no Dotb.

Um anúncio criado a partir do seu script através da API

Agende as suas publicações

Incluído no Boutique AI

Envie até 250 anúncios criados no Dotb e ainda não publicados na Vinted (com pelo menos uma fotografia) numa só chamada para POST /items/schedule, cada um com a sua data e hora, e o Dotb publica-os na Vinted nesses momentos, ou deixa-os como rascunhos na Vinted. Importante: quem publica é a extensão do Dotb, por isso a extensão tem de estar em funcionamento (navegador aberto, extensão ativa) tanto quando agenda como quando a publicação é executada; depois de entrar na fila, a publicação agendada aguarda e é repetida quando a extensão voltar.

Anúncios agendados num calendário, publicados pela extensão

Consulte as suas encomendas da Vinted

Incluído no Boutique AI

Aceda às encomendas que o Dotb sincronizou a partir da sua conta da Vinted e utilize-as nos seus próprios painéis, folhas de cálculo ou fluxos de trabalho.

Encomendas da Vinted enviadas para um painel e uma folha de cálculo

Ferramentas criadas pelos nossos utilizadores

Ligue o seu assistente de IA à API e comece a construir

A API do Dotb está descrita para assistentes de IA: um resumo legível por máquina (llms.txt), a especificação OpenAPI e uma referência interativa para testar cada chamada a partir do navegador.

  1. 1 Crie um token de API nas suas definições (plano Boutique AI).
  2. 2 Dê ao seu assistente de IA (ChatGPT, Claude, Cursor…) a ligação para o llms.txt.
  3. 3 Descreva a ferramenta que pretende, deixe-o escrever o código e execute-o com o seu token.
Instruções para o seu agente de IA 
Estás a ajudar-me a construir uma ferramenta sobre a API pública do Dotb (automatização para vendedores da Vinted).

1. Lê primeiro a descrição da API: https://dotb.io/api/public/v1/llms.txt (especificação OpenAPI: https://dotb.io/api/public/v1/openapi.json).
2. URL base: https://dotb.io/api/public/v1. Envia `Authorization: Bearer <token>` em cada pedido. Lê o token da variável de ambiente DOTB_API_TOKEN; nunca o escrevas no código, não o registes nem o mostres.
3. Começa com GET /accounts para verificar o token e listar as minhas contas Vinted.
4. A API trabalha com os meus dados no Dotb, não diretamente com a Vinted. Cria os anúncios com POST /items, adiciona pelo menos uma foto com POST /items/{id}/photos e agenda a sua publicação com POST /items/schedule (até 250 por chamada). É a extensão Dotb que publica, por isso tem de estar ativa num navegador aberto ao agendar e à hora da publicação.
5. Lê as minhas encomendas com GET /orders e GET /orders/{id}.
6. Respeita os limites (60 pedidos por minuto, 10 000 por dia por token): perante um 429, espera os segundos indicados em Retry-After. Os erros têm a forma {"error": {"type", "message", "details", "request_id"}}: mostra-me a mensagem e o request_id.
7. Pergunta-me antes de apagar o que quer que seja ou de cancelar um agendamento.

A ferramenta que quero: [descreva aqui a sua ferramenta]
Um assistente de IA a escrever código a partir da descrição da API

Uma API da Vinted para as suas próprias ferramentas

Cada loja na Vinted funciona de forma um pouco diferente. A API REST pública do Dotb permite construir a ferramenta que se adapta à sua: crie anúncios no Dotb a partir dos seus próprios scripts e consulte as encomendas da Vinted que o Dotb sincronizou, e depois publique os anúncios na Vinted com a extensão do navegador. A API não interage diretamente com a Vinted, trabalha com os seus dados no Dotb. Também pode trazer anúncios de uma folha de cálculo com a importação CSV e acompanhar as vendas na gestão de encomendas.

O seu assistente de IA pode escrever o código

A API inclui um resumo legível por máquina em /api/public/v1/llms.txt e a especificação OpenAPI original em /api/public/v1/openapi.json. Dê um deles ao ChatGPT, ao Claude, ao Cursor ou a outro assistente de IA, descreva a ferramenta que pretende e ele pode escrever o código.

Agendar publicações

POST /items/schedule agenda até 250 anúncios criados no Dotb e ainda não publicados na Vinted (com pelo menos uma fotografia) numa só chamada, cada um com a sua hora de publicação, e GET /scheduled-publishes mostra o resultado de cada um. A extensão do Dotb faz cada publicação agendada: o navegador tem de estar aberto e a extensão ativa tanto quando agenda como quando a publicação é executada. Depois de entrar na fila, a publicação agendada aguarda e é repetida quando a extensão voltar.

Autenticação

Cada pedido é autenticado com um token de API pessoal, enviado como token Bearer no cabeçalho Authorization. Crie e faça a gestão dos seus tokens nas definições de tokens de API. O URL base é https://dotb.io/api/public/v1, e a referência interativa da API permite percorrer todos os endpoints e testar as chamadas no navegador.

Leia o guia completo: Referência da API.

Perguntas frequentes

Outras funcionalidades

A vender na Vinted?

Junte-se a mais de 17,371 vendedores que usam o Dotb para expandir a sua loja Vinted.

Google Chrome Adicionar ao Chrome