API di recensioni Google per sviluppatori

Autenticazione

Genera una chiave API da Impostazioni → API nel tuo pannello. Ogni chiave viene mostrata una sola volta alla creazione — conservala in un posto sicuro. Inviala nell'header Authorization di ogni richiesta:

curl -H "Authorization: Bearer rvd_live_..." \
  "https://reviews-api.rovidev.com/api/v1/locations"

GET /api/v1/locations

Restituisce le sedi attive della tua organizzazione.

{
  "id": "b3f1...",
  "name": "Cafetería El Sol - Centro"
}

GET /api/v1/reviews

Restituisce le recensioni della tua organizzazione, paginate. Supporta i filtri status (pending, negative, published), location_id, platform (google, facebook, tripadvisor), page e page_size.

curl -H "Authorization: Bearer rvd_live_..." \
  "https://reviews-api.rovidev.com/api/v1/reviews?status=negative&page=1&page_size=50"

{
  "items": [
    {
      "id": "9c2a...",
      "location_id": "b3f1...",
      "location_name": "Cafetería El Sol - Centro",
      "platform": "google",
      "star_rating": 5,
      "comment": "Trato excelente",
      "reviewer_name": "Ana",
      "sentiment": "positive",
      "review_created_at": "2026-08-20T10:15:00",
      "reply_status": "published",
      "reply_content": "¡Muchas gracias, Ana!"
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 50
}

Anche in JavaScript / Node

const res = await fetch(
  "https://reviews-api.rovidev.com/api/v1/reviews?status=negative&page=1&page_size=50",
  { headers: { Authorization: "Bearer rvd_live_..." } }
)
const { items, total } = await res.json()

POST /api/v1/review-requests

Avvia una richiesta di recensione nel momento esatto in cui un ordine, una prenotazione o un appuntamento viene completato, invece di dipendere dal caricamento manuale di un elenco di contatti. Supporta i canali email, sms e whatsapp.

curl -X POST -H "Authorization: Bearer rvd_live_..." \
  -H "Content-Type: application/json" \
  -d '{"channel":"email","name":"Ana","email":"ana@example.com"}' \
  "https://reviews-api.rovidev.com/api/v1/review-requests"

{
  "id": "7e4b...",
  "status": "sent",
  "channel": "email",
  "recipient": "ana@example.com"
}

Anche in JavaScript / Node

await fetch("https://reviews-api.rovidev.com/api/v1/review-requests", {
  method: "POST",
  headers: {
    Authorization: "Bearer rvd_live_...",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ channel: "email", name: "Ana", email: "ana@example.com" })
})

Webhook

Configura un URL da Impostazioni → API per ricevere una POST ogni volta che si verifica un evento, invece di interrogare periodicamente la API. Massimo 5 webhook attivi per organizzazione.

Eventi disponibili

• review.created
• review.replied
• daily.summary

Verificare la firma

Ogni invio include l'header X-RoviDev-Signature: un HMAC-SHA256 del corpo della richiesta, calcolato con il secret mostrato alla creazione del webhook. Verificalo sul tuo server prima di elaborare l'evento:

import hashlib
import hmac

expected = hmac.new(secret.encode(), request.body, hashlib.sha256).hexdigest()
hmac.compare_digest(expected, request.headers["X-RoviDev-Signature"])

Anche in JavaScript / Node

const crypto = require("crypto")

const expected = crypto
  .createHmac("sha256", secret)
  .update(rawBody)
  .digest("hex")
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(req.headers["x-rovidev-signature"]))