Resmi Google OAuth Entegrasyonu

LocalEdge Guardian API

Webhook ile gercek zamanli Google Business Profile uyarilari. Konumlarinizi koruyun. Operasyonlari otomatiklestirin.

Kimlik dogrulama

Tum istekler X-Api-Key basliginda API anahtarinizi gerektirir.

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

Endpointler

POST/api/v1/guardian/subscribe

Bir GBP konumunu webhook olaylarina (ve istege bagli e-posta ozetine) abone edin.

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

API anahtariniz icin tum aktif abonelikleri listeleyin.

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

Kimlige gore bir aboneligi devre disi birakin.

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}

Bir profil icin son webhook teslimat gunlugunu alin.

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

Olay katalogu

API olay adlarinin izledigimiz Google Business Profile alanlariyla eslesmesi.

Olay GBP Alani
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 yuk

Her teslimat HMAC-SHA256 ile imzalanmis bir JSON POST'tur.

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

Alinan Basliklar

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

E-posta ozeti (istege bagli)

LocalEdge uzerinden HTML uyari e-postasi almak icin abonelikte notify_email gonderin.

{
  "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 erisimi iste

Tesekkurler! En kisa surede sizinle iletisime gececegiz.

Yakinda

Daha fazla LocalEdge API yol haritasinda.

Heatmap API Yakinda
GBP Score API Yakinda
AVI Content API Yakinda