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"
πŸ§ͺ
Sandbox mode

Use gbp_id: TEST_PROFILE and any webhook_url to simulate Guardian events without a real GBP location.

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":"TEST_PROFILE","webhook_url":"https://yourapp.com/test","events":["hours_changed"]}'

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"
  }'

Expected response (201):

{
  "success": true,
  "subscription_id": 42,
  "gbp_id": "YOUR_GBP_ID",
  "events": ["hours_changed", "status_suspended"],
  "webhook_url": "https://yourapp.com/webhook",
  "created_at": "2026-10-08T10:00:00Z"
}
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"
GET /api/v1/guardian/proactive-hint/{profile_id}

Instant AI signal β€” no LLM call, sub-100ms response. Use this to power real-time CRM alerts.

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

Response:

{
  "hint": "GBP hours changed 2 days ago β€” verify with your client immediately.",
  "trigger_key": "hours_changed",
  "urgency": "high",
  "lang": "en"
}

Error Codes

CodeMeaningAction
401Invalid or missing API keyCheck X-Api-Key header
403Quota exceeded or plan limit reachedUpgrade plan or wait for reset
422Missing or invalid parameterCheck required fields in request body
429Rate limit exceededSlow down requests β€” max 60/min
500Server errorRetry after 30s or contact support

Use Cases

πŸ””

Slack alert on GBP change

Your client's GBP hours change β†’ Guardian webhook fires β†’ your server posts a Slack message instantly.

GBP Change β†’ Guardian Webhook β†’ Slack Alert
πŸ“Š

CRM auto-task on suspension

GBP suspended β†’ webhook triggers a CRM task assigned to the account manager within seconds.

GBP Suspended β†’ Guardian Webhook β†’ CRM Task
⚑

Real-time dashboard widget

Poll /proactive-hint every 60s to display live GBP health scores in your own client dashboard.

Poll /proactive-hint β†’ Every 60s β†’ Live Dashboard

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