Integracion OAuth Google Oficial

API LocalEdge Guardian

Alertas de Google Business Profile en tiempo real via webhooks. Proteja sus fichas. Automatice sus ops.

Autenticacion

Todas las solicitudes requieren su clave API en el encabezado X-Api-Key.

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

Endpoints

POST/api/v1/guardian/subscribe

Suscribir una ficha GBP a eventos webhook (y digest email opcional).

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

Listar todas las suscripciones activas de su clave API.

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

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

Desactivar una suscripcion por 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}

Obtener logs recientes de entrega webhook de un perfil.

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

Catalogo de eventos

Correspondencia entre nombres de eventos API y campos de Google Business Profile monitoreados.

Evento	Campo 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

Cada entrega es un POST JSON firmado con 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 recibidos

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

Digest email (opcional)

Pase notify_email en la suscripcion para recibir tambien emails HTML de alerta 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"
}

Solicitar acceso API

Gracias! Nos pondremos en contacto pronto.

Proximamente

Mas APIs LocalEdge estan en la hoja de ruta.

Heatmap API Proximamente

GBP Score API Proximamente

AVI Content API Proximamente