Offizielle Google OAuth Integration

LocalEdge Guardian API

Echtzeit-Google-Business-Profile-Alerts per Webhook. Schuetzen Sie Ihre Profile. Automatisieren Sie Ihre Ops.

Authentifizierung

Alle Anfragen erfordern Ihren API-Schluessel im Header X-Api-Key.

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

Endpoints

POST/api/v1/guardian/subscribe

Ein GBP-Profil fuer Webhook-Events (und optionalen E-Mail-Digest) abonnieren.

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

Alle aktiven Abonnements fuer Ihren API-Schluessel auflisten.

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

DELETE/api/v1/guardian/subscribe/{id}

Ein Abonnement per ID deaktivieren.

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}

Aktuelle Webhook-Lieferlogs fuer ein Profil abrufen.

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

Event-Katalog

Zuordnung von API-Eventnamen zu den ueberwachten Google-Business-Profile-Feldern.

Ereignis	GBP-Feld
`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`

Webhook-Payload

Jede Zustellung ist ein JSON-POST, signiert mit 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"
}

Empfangene Headers

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

E-Mail-Digest (optional)

Uebergeben Sie notify_email beim Abonnement, um auch HTML-Alert-E-Mails via LocalEdge zu erhalten.

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

API-Zugang anfragen

Danke! Wir melden uns in Kuerze.

Demnachst

Weitere LocalEdge-APIs stehen auf der Roadmap.

Heatmap API Demnachst

GBP Score API Demnachst

AVI Content API Demnachst