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

Marquer une fiche comme doublon

Marque un ou plusieurs éléments de fiche détectés comme doublons confirmés afin que Listings API puisse les supprimer.

Nécessite une clé API. Consultez Authentification pour le format de l’en-tête et la rotation des clés.

Paramètres

Corps

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

Exemple de requête

Corps prêt à coller. Remplacez les identifiants et valeurs d’exemple par les vôtres.

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

Réponses

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.

Confirme que certains éléments de fiche sont des doublons, indiquant à Listings API de les supprimer ou de les nettoyer. Renseignez listingItemIds avec les valeurs listingItemId renvoyées par Obtenir les fiches en doublon pour un établissement (ou les valeurs id issues de la synthèse à l’échelle du compte).

Cas d’utilisation : traiter un doublon vérifié

Une fois qu’une personne chargée de la vérification a confirmé un groupe de doublons, envoyez les identifiants des éléments concernés en un seul appel :

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

listingItemIds est obligatoire et accepte plusieurs identifiants ; regroupez donc tous les doublons confirmés d’un établissement dans une seule requête plutôt que d’effectuer un appel par fiche. Un 200 avec success: true signifie que les éléments ont été acceptés pour suppression ; un 200 avec success: false (ou un 400) renvoie un tableau errors contenant des entrées : examinez les champs code et message de chaque entrée avant de réessayer.

Cas d’utilisation : corriger une erreur

Si un élément a été marqué par erreur, annulez ce marquage avec Marquer une fiche comme n’étant pas un doublon, qui accepte la même structure de corps de requête. Il s’agit d’une opération d’écriture qui est comptabilisée dans la limite de débit du compte ; privilégiez donc le traitement par lots plutôt que les requêtes par élément.

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