v1Ressources/Fiches en double/postRésoudre des fiches en double

Résoudre des fiches en double

Marque des fiches en double pour suppression, ou les rejette, soit via une liste explicite de duplicateListingIds, soit via un filtre correspondant à la même forme que la file de synthèse. Le mode filtre s'exécute comme une seule mise à jour groupée restreinte à l'intersection des statuts propres au filtre et des statuts source éligibles de l'action — il ne peut jamais atteindre des lignes hors de ce que ce filtre afficherait. Marquer ne supprime pas la fiche elle-même ; cela met en file la demande de suppression, qu'un job en arrière-plan exécute ensuite auprès du publisher.

post/api/v1/listings/duplicates/resolve

listings:write

Corps de la requête

actionstring (flag | dismiss)obligatoire

flag (demander la suppression auprès du publisher) ou dismiss (marquer comme n'étant pas un doublon).

duplicateListingIdsarray of stringfacultatif

Ids explicites à résoudre, jusqu'à 1000. Exclusif avec filter.

filterobjectfacultatif

Résout chaque ligne éligible correspondant à ce filtre au lieu de nommer explicitement des ids. Une clé limitée à des clients spécifiques doit aussi passer clientId en mode filtre.

filterstring (potential | flagged | deleted | failed)facultatif

Restreint à un seul statut : potential, flagged, deleted ou failed.

bandstring (high | med | low)facultatif

Restreint à une seule tranche de confiance : high, med ou low.

publisherSiteIdintegerfacultatif

Restreint à un seul publisher, par son site id numérique.

locationIdstringfacultatif

Restreint à un seul établissement.

searchstringfacultatif

Recherche en texte libre sur le nom commercial, l'adresse et le téléphone.

clientIdstringfacultatif

Obligatoire quand votre clé est limitée à des clients spécifiques et que vous utilisez le mode filtre (le mode id est auto-limité par id et n'en a pas besoin).

Réponse

dataobjectfacultatif

updatednumberfacultatif

Nombre de fiches en double ayant transité vers le nouveau statut.

skippedarray of stringfacultatif

Ids demandés qui N'ONT PAS transité — introuvables, non détenus par votre agence/client, ou pas dans un statut source éligible. Toujours vide en mode filtre.

Erreurs

400Il manque un paramètre requis à la requête, ou elle est invalide.

401Clé API manquante, invalide, expirée ou révoquée.

403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.

429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.

post/api/v1/listings/duplicates/resolve

Votre clé API

Corps de la requête*

{
  "data": {
    "updated": 3,
    "skipped": []
  }
}