/api/v4/locations/listings/mark-as-duplicateMarcar una ficha como duplicada
Marca uno o varios elementos de ficha detectados como duplicados confirmados para que Listings API pueda suprimirlos.
Parámetros
Cuerpo
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| input.listingItemIds | array | obligatorio | Array of base64-encoded listing item IDs to mark as duplicates. Use the `listingItemId` values from the duplicate-listings endpoints. |
| input.locationId | string | opcional | Location that owns the listing items (base64-encoded Relay ID or raw numeric ID). Scopes the operation to a single location. |
Solicitud de ejemplo
Cuerpo listo para pegar. Sustituye los ID y valores de ejemplo por los tuyos.
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="] }}Respuestas
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.
Confirma que determinados elementos de ficha son duplicados e indica a Listings API que debe suprimirlos o eliminarlos. Rellena listingItemIds con los valores de listingItemId devueltos por Obtener fichas duplicadas de una ubicación (o los valores de id del resumen consolidado de toda la cuenta).
Caso de uso: actuar sobre un duplicado revisado
Después de que una persona encargada de la revisión confirme un grupo de duplicados, envía los IDs de los elementos duplicados en una sola llamada:
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="] }}listingItemIds es obligatorio y acepta varios IDs, así que agrupa todos los duplicados confirmados de una ubicación en una sola solicitud en lugar de hacer una llamada por ficha. Un 200 con success: true significa que se ha aceptado la supresión de los elementos; un 200 con success: false (o un 400) devuelve un array errors con datos; inspecciona code y message de cada entrada antes de volver a intentarlo.
Caso de uso: corregir un error
Si un elemento se marcó por error, deshaz la acción con Marcar una ficha como no duplicada, que acepta la misma estructura del cuerpo. Esta es una operación de escritura y cuenta para el límite de solicitudes de la cuenta, así que prioriza la agrupación en lotes frente a las solicitudes por 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=" ] } }'