/api/v4/locations/listings/mark-as-duplicateContrassegna una scheda come duplicata
Contrassegna uno o più elementi di scheda rilevati come duplicati confermati, in modo che Listings API possa sopprimerli.
Parametri
Corpo
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| input.listingItemIds | array | obbligatorio | Array of base64-encoded listing item IDs to mark as 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 marked as duplicates. On failure, `success` is `false` and `errors` describes why.
{ "data": { "markAsDuplicate": { "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.
Conferma che specifici elementi di scheda sono duplicati, segnalando a Listings API di sopprimerli o rimuoverli. Compila listingItemIds con i valori listingItemId restituiti da Ottieni le schede duplicate per una sede (o con i valori id del riepilogo aggregato dell'intero account).
Caso d'uso: intervenire su un duplicato verificato
Dopo che un revisore ha confermato un gruppo di duplicati, invia gli ID degli elementi interessati in un'unica chiamata:
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="] }}listingItemIds è obbligatorio e accetta più ID, quindi raggruppa tutti i duplicati confermati per una sede in un'unica richiesta anziché effettuare una chiamata per ogni scheda. Un 200 con success: true indica che gli elementi sono stati accettati per la soppressione; un 200 con success: false (o un 400) restituisce un array errors popolato: controlla code e message di ogni voce prima di riprovare.
Caso d'uso: annullare un errore
Se un elemento è stato contrassegnato per errore, annulla l'operazione con Contrassegna una scheda come non duplicata, che accetta la stessa struttura del corpo della richiesta. Questa è un'operazione di scrittura e viene conteggiata nel limite di frequenza delle richieste 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-duplicate' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": [ "TGlzdGluZ0l0ZW06MjM1OTg0NTA=" ] } }'