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

Contrassegna una scheda come non duplicata

Scarta uno o più potenziali duplicati come falsi positivi, in modo che non compaiano più nell'elenco dei duplicati.

Richiede una chiave API. Consulta Autenticazione per il formato dell’header e la rotazione delle chiavi.

Parametri

Corpo

NomeTipoObbligatorioDescrizione
input.listingItemIdsarrayobbligatorioArray of base64-encoded listing item IDs to dismiss as not duplicates. Use the `listingItemId` values from the duplicate-listings endpoints.
input.locationIdstringfacoltativoLocation that owns the listing items (base64-encoded Relay ID or raw numeric ID). Scopes the operation to a single location.

Richiesta di esempio

Corpo pronto da incollare. Sostituisci gli ID e i valori segnaposto con i tuoi.

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

Risposte

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.

Scarta i potenziali duplicati come falsi positivi. Una volta scartati, gli elementi vengono contrassegnati come non duplicati confermati e non compaiono più in Ottieni le schede duplicate per una sede o nel riepilogo a livello di account. Compila listingItemIds con i valori di listingItemId restituiti da questi endpoint.

Caso d'uso: rimuovere i falsi positivi dalla coda

Il rilevamento è prudenziale e segnala anche schede legittime che sono semplicemente simili (un secondo profilo valido, un'altra sede dello stesso franchising, una sede rinominata). Quando chi effettua la verifica conferma che una voce corrisponde alla scheda corretta, scartala in modo che non ingombri più la coda dei duplicati:

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

listingItemIds è obbligatorio e accetta più ID: raggruppa tutti i falsi positivi di una sede in un'unica chiamata. Un 200 con success: true conferma che gli elementi sono stati scartati; success: false o un 400 restituisce un array errors popolato da esaminare.

Caso d'uso: l'operazione inversa della soppressione

Questo endpoint è la controparte di Contrassegna una scheda come duplicata e accetta un corpo con la stessa struttura; usalo per annullare la segnalazione di un elemento contrassegnato per errore. Entrambe sono operazioni di scrittura che vengono conteggiate ai fini del limite di frequenza dell'account, quindi preferisci le richieste in blocco a quelle per singolo elemento.

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="      ]    }  }'