Integration OAuth Google Officielle

API LocalEdge Guardian

Alertes Google Business Profile en temps reel via webhooks. Protegez vos fiches. Automatisez vos ops.

Authentification

Toutes les requetes exigent votre cle API dans l'en-tete X-Api-Key.

curl https://avision.org/api/v1/guardian/subscriptions \
  -H "X-Api-Key: YOUR_API_KEY"

Endpoints

POST/api/v1/guardian/subscribe

Abonner une fiche GBP aux evenements webhook (et digest email optionnel).

curl -X POST https://avision.org/api/v1/guardian/subscribe \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "gbp_id": "YOUR_GBP_ID",
    "profile_id": 123,
    "webhook_url": "https://yourapp.com/webhook",
    "events": ["hours_changed","status_suspended"],
    "notify_email": "you@yourcompany.com"
  }'
GET/api/v1/guardian/subscriptions

Lister tous les abonnements actifs pour votre cle API.

curl https://avision.org/api/v1/guardian/subscriptions \
  -H "X-Api-Key: YOUR_API_KEY"
DELETE/api/v1/guardian/subscribe/{id}

Desactiver un abonnement par ID.

curl -X DELETE https://avision.org/api/v1/guardian/subscribe/1 \
  -H "X-Api-Key: YOUR_API_KEY"
GET/api/v1/guardian/logs/{profile_id}

Recuperer les logs de livraison webhook recents pour un profil.

curl https://avision.org/api/v1/guardian/logs/123 \
  -H "X-Api-Key: YOUR_API_KEY"

Catalogue d'evenements

Correspondance entre noms d'evenements API et champs Google Business Profile surveilles.

Evenement Champ GBP
hours_changed regularHours
title_changed title
phone_changed phoneNumbers
address_changed storefrontAddress
website_changed websiteUri
description_changed description
categories_changed categories
special_hours_changed specialHours
open_status_changed openInfo
service_area_changed serviceArea
appointment_url_changed url_appointment
appointments_changed offers_online_appointments
location_changed latlng
additional_categories_changed additional_categories
competitor_overtake competitor_overtake
status_suspended suspension

Payload webhook

Chaque livraison est un POST JSON signe en HMAC-SHA256.

{
  "event": "hours_changed",
  "gbp_id": "YOUR_GBP_ID",
  "profile_id": 123,
  "old_value": "Mon-Fri 9am-6pm",
  "new_value": "Mon-Fri 9am-8pm",
  "detected_at": "2026-10-01T10:00:00"
}

Headers recus

X-LocalEdge-Signature: <hmac-sha256>
X-LocalEdge-Event: hours_changed

Digest email (optionnel)

Passez notify_email a l'abonnement pour recevoir aussi des emails HTML d'alerte via LocalEdge.

{
  "gbp_id": "YOUR_GBP_ID",
  "profile_id": 123,
  "webhook_url": "https://yourapp.com/webhook",
  "events": ["hours_changed","status_suspended"],
  "notify_email": "you@yourcompany.com"
}

Demander un acces API

Merci ! Nous vous recontacterons rapidement.

Bientot disponible

D'autres API LocalEdge sont sur la roadmap.

Heatmap API Bientot
GBP Score API Bientot
AVI Content API Bientot