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

Marcar una ficha como duplicada

Marca uno o varios elementos de ficha detectados como duplicados confirmados para que Listings API pueda suprimirlos.

Requiere una clave de API. Consulta Autenticación para conocer el formato del encabezado y la rotación de claves.

Parámetros

Cuerpo

NombreTipoObligatorioDescripción
input.listingItemIdsarrayobligatorioArray of base64-encoded listing item IDs to mark as 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.

Solicitud de ejemplo

Cuerpo listo para pegar. Sustituye los ID y valores de ejemplo por los tuyos.

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

Respuestas

200Listing items marked as duplicates. On failure, `success` is `false` and `errors` describes why.
Response
{  "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:

JSON
{  "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.

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