/api/v4/locations/listings/mark-as-duplicateMarquer 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.
Paramètres
Corps
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| input.listingItemIds | array | obligatoire | Array of base64-encoded listing item IDs to mark as duplicates. Use the `listingItemId` values from the duplicate-listings endpoints. |
| input.locationId | string | facultatif | Location 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.
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="] }}Réponses
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.
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 :
{ "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.
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=" ] } }'