POST/api/v4/locations/listings/mark-as-not-duplicate

Marcar listagem como não duplicada

Descarta uma ou mais possíveis duplicatas como falsos positivos para que deixem de aparecer na lista de duplicatas.

Requer uma chave de API. Consulte Autenticação para ver o formato do cabeçalho e a rotação de chaves.

Parâmetros

Corpo

NomeTipoObrigatórioDescrição
input.listingItemIdsarrayobrigatórioArray of base64-encoded listing item IDs to dismiss as not duplicates. Use the `listingItemId` values from the duplicate-listings endpoints.
input.locationIdstringopcionalLocation that owns the listing items (base64-encoded Relay ID or raw numeric ID). Scopes the operation to a single location.

Exemplo de requisição

Corpo pronto para colar. Substitua os IDs e valores de exemplo pelos seus.

Request body
{  "input": {    "locationId": "TG9jYXRpb246MTgwMDI4OQ==",    "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="]  }}

Respostas

200Listing items dismissed as not duplicates. On failure, `success` is `false` and `errors` describes why.
Response
{  "data": {    "markAsNotDuplicate": {      "success": true,      "errors": null    }  }}
400Validation error, e.g. an unknown or malformed listing item ID. See the `errors` array (`code`, `message`, `path`).
401Unauthenticated, missing or invalid API key.

Descarta possíveis duplicatas como falsos positivos. Depois de descartados, os itens são marcados como não duplicados confirmados e deixam de aparecer em Obter listagens duplicadas de um local ou na visão consolidada de toda a conta. Preencha listingItemIds com os valores de listingItemId desses endpoints.

Caso de uso: remover falsos positivos da fila

A detecção é conservadora e sinalizará listagens legítimas que apenas parecem semelhantes (um segundo perfil válido, outra unidade da mesma franquia, um local renomeado). Quando a pessoa responsável pela análise confirmar que uma entrada é a listagem correta, descarte-a para que ela deixe de ocupar desnecessariamente a fila de duplicatas:

JSON
{  "input": {    "locationId": "TG9jYXRpb246MTgwMDI4OQ==",    "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="]  }}

listingItemIds é obrigatório e aceita vários IDs: agrupe todos os falsos positivos de um local em uma única chamada. Um 200 com success: true confirma o descarte; success: false ou um 400 retorna um array errors preenchido para você inspecionar.

Caso de uso: o inverso da supressão

Este endpoint é a contraparte de Marcar listagem como duplicada e aceita a mesma estrutura de corpo; use-o para reverter a marcação de um item sinalizado por engano. Ambos são operações de escrita que contam para o limite de requisições da conta, portanto prefira agrupar os itens em vez de enviar uma requisição por item.

Request
curl -X POST 'https://listingsapi.com/api/v4/locations/listings/mark-as-not-duplicate' \  -H "Authorization: API $LISTINGSAPI_KEY" \  -H 'Content-Type: application/json' \  -d '{    "input": {      "locationId": "TG9jYXRpb246MTgwMDI4OQ==",      "listingItemIds": [        "TGlzdGluZ0l0ZW06MjM1OTg0NTA="      ]    }  }'