Pular para o conteúdo principal

Exclui marcas existentes

Este endpoint é utilizado para excluir um lote de marcas de uma vez. Esse processo é ideal para sistemas que precisam integrar/excluir uma lista de marcas.

DELETE /v1/batch/brands​

  • Authorization: Basic Auth contendo a chave publica e secreta disponibilizadas para o cliente.
    • Exemplo: Basic <base64-encoded-credentials>

Exemplo de Autorização​

Para gerar o valor de Authorization, você precisa codificar suas credenciais (public_key:secret_key) em base64. Por exemplo, se sua chave pública for public_key e sua chave secreta for secret_key, você deve codificar public_key:secret_key em base64.

echo -n 'public_key:secret_key' | base64

Corpo da Requisição​

O corpo da requisição deve ser uma lista de objetos de marca, cada um contendo os seguintes campos:

Exemplo de Corpo da Requisição​

[
  "0ac2ee7a-9a01-4944-9ae4-7b5235ca358e",
  "22185712-f047-4c3e-b8e3-d2be2c5e8c97",
  "529c7ff0-811c-4c4c-b84c-4ba17a4f3da3",
  "..."
]

Respostas​

  • 200: Retorna sucesso da operação. A resposta incluirá detalhes sobre o processamento da lista de produtos.
  • 400: Retorna erro de requisição inválida. Isso geralmente ocorre devido a dados de entrada mal formatados ou faltando.
  • 500: Retorna erro interno do servidor. Indica problemas no processamento da requisição no servidor.

Exemplo de Resposta para Sucesso (200)​

{ "operationId": "402fe685-2060-432b-ac57-223eb2e680f3" }

Exemplo de Resposta para Erro (400)​

{
  "error": "Invalid request",
  "details": "The name field is missing in one of the brand items."
}

Mensagem de notificação webhook​

Quando a operação é bem-sucedida, uma mensagem é enviada para os endpoints de notificação registrados pelo webhook. A mensagem contém o ID, o status da operação detalhes do retorno.

{
  "operationId": "54d6a979-5f62-4e17-9d4c-dbd9f5ede403",
  "relatedEntity": "Brand",
  "eventType": 4,
  "data": {
    "externalReference": "1",
    "name": "Marca",
    "title": "Marca",
    "description": "Marca",
    "punctuation": 1,
    "similarTerms": "Marca, Marca famosa"
  },
  "contractAccountId": "9f36a666-acd5-4987-a47f-3de247f65d82"
}
  • OperationId: Identificador único da operação.
  • RelatedEntity: Entidade relacionada ao evento (por exemplo, Brand).
  • EventType: Tipo de evento (por exemplo, Brand_Deleted).
    • Os tipos possíveis relevantes para marcas são:
      • Brand_Created = 4
      • Brand_Updated = 5
      • Brand_Deleted = 6
  • Data: Dados específicos do evento.
  • ContractAccountId: Identificador da conta do contrato.
  • Error: Detalhes do erro caso exista algum.