Fluxos de trabalho de API

Receber uma lista de pacotes de leilão

Chame a API LIST. Aceita filtragem por external_deal_id

Criar um pacote de leilão

  1. O external_deal_id precisa ser exclusivo. Chame LIST com external_deal_id para verificar se o ID já foi usado.
  2. Chame Create API. Um nome exclusivo será atribuído e poderá ser usado para receber o pacote criado.
  3. Chame Get API para conferir os detalhes do pacote de leilão criado.
  4. Opcional: faça upload de um logo para o pacote criado.

Atualizar pacote de leilão

  1. Se você não armazenar o nome do pacote de leilão criado, chame o filtro API LIST por external_deal_id para receber o pacote de leilão que você quer atualizar.
  2. Atualize os campos com base nos resultados da API LIST.
  3. Chame a API Patch para atualizar o pacote de leilão. O "updateMask" é obrigatório e indica a quais campos você quer que a atualização seja aplicada. Somente os campos que podem ser atualizados podem ser definidos na "updateMask".

Processo Beta

A única diferença entre a versão Beta e a GA é que, durante o período Beta, os pacotes de leilão criados precisam ter o status definido como "DISCOVERY_OBJECT_STATUS_PAUSED", e o status não pode ser atualizado. Os pacotes PAUSADOS não ficam visíveis na interface do DV3. Isso permite que as exchanges testem a integração da API sem mostrar os pacotes de teste.

É comum criar todos os pacotes "reais" na versão Beta como PAUSADOS e depois "ativá-los" quando a GA for lançada.

Cota

2.000 pacotes ativos por troca.

2.000 pacotes pausados por troca.