/api/v4/locations/listings/mark-as-not-duplicateContrassegna una scheda come non duplicata
Scarta uno o più potenziali duplicati come falsi positivi, in modo che non compaiano più nell'elenco dei duplicati.
Parametri
Corpo
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| input.listingItemIds | array | obbligatorio | Array of base64-encoded listing item IDs to dismiss as not duplicates. Use the `listingItemId` values from the duplicate-listings endpoints. |
| input.locationId | string | facoltativo | Location 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.
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="] }}Risposte
200Listing items dismissed as not duplicates. On failure, `success` is `false` and `errors` describes why.
{ "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:
{ "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.
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=" ] } }'