Integracao OAuth Google Oficial

API LocalEdge Guardian

Alertas do Google Business Profile em tempo real via webhooks. Proteja seus perfis. Automatize suas ops.

Autenticacao

Todas as solicitacoes exigem sua chave API no cabecalho X-Api-Key.

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

Endpoints

POST/api/v1/guardian/subscribe

Inscrever um perfil GBP em eventos webhook (e 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 as inscricoes ativas da sua chave API.

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

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

Desativar uma inscricao 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}

Obter logs recentes de entrega webhook de um perfil.

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

Catalogo de eventos

Correspondencia entre nomes de eventos API e campos do Google Business Profile monitorados.

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 e um POST JSON assinado com 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 recebidos

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

Digest email (opcional)

Passe notify_email na inscricao para tambem receber 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 acesso API

Obrigado! Entraremos em contato em breve.

Em breve

Mais APIs LocalEdge estao no roadmap.

Heatmap API Em breve

GBP Score API Em breve

AVI Content API Em breve