Synupv1
Créer une clé
v1Ressources/Connexions/postConfirmer une correspondance suggérée

Confirmer une correspondance suggérée

Confirme une suggestion du score NAP, créant une connexion au niveau de l'emplacement à partir d'une fiche récupérée déjà associée à un emplacement Synup. Échoue si la fiche n'a pas d'emplacement associé (400), est déjà connectée (409), ou si l'emplacement a déjà une connexion sur cette plateforme (409).

post/api/v1/connections/locations/confirm-match
connections:write
Corps de la requête
fetchedListingIdstringobligatoire
La fiche récupérée à confirmer. Obligatoire.
Réponse
dataobjectfacultatif
idstringfacultatif
Identifiant unique de la connexion résultante.
platformstring (google | facebook)facultatif
La plateforme sur laquelle la fiche a été associée.
synupLocationIdstringfacultatif
L'id Synup existant de l'emplacement, ou null pour un emplacement natif.
clientLocationIdstringfacultatif
L'id de l'emplacement.
platformResourceNamestringfacultatif
Le nom/id de ressource de la fiche sur la plateforme.
platformPageNamestringfacultatif
Le nom d'affichage de la fiche sur la plateforme.
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.
404La ressource est introuvable, ou n'appartient pas à votre agence.
409La requête entre en conflit avec l'état actuel de la ressource — par exemple, modifier l'e-mail ou le téléphone d'un destinataire à qui un message a déjà été envoyé, ou une invitation d'équipe déjà acceptée (ou pas encore acceptée).
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
post/api/v1/connections/locations/confirm-match
Votre clé API
Corps de la requête*
{
  "data": {
    "id": "listing_1",
    "platform": "google",
    "synupLocationId": null,
    "clientLocationId": "loc_456",
    "platformResourceName": "accounts/123/locations/456",
    "platformPageName": "Acme Dental — Downtown"
  }
}