API Praça · Geo

Praça Geo IP

Geolocalização aproximada por IPv4. Usa X-Forwarded-For quando atrás de proxy. O IP nunca é persistido em texto claro — apenas ip_hash (SHA-256 + salt).

Solicitar API key

Privacidade

• Cache em geo_ip_cache indexado por hash
• Log de auditoria com ip_hash + hash do caller
• Stub determinístico (sem bureau externo no MVP)
• service_key: nexa.geo.ip

GET /api/nexa/geo/ip
Header: X-Forwarded-For: 177.54.12.34

{
  "ok": true,
  "data": {
    "ip_hash": "a3f2…",
    "country_code": "BR",
    "country_name": "Brasil",
    "region": "Sudeste",
    "city": "São Paulo",
    "timezone": "America/Sao_Paulo",
    "is_private": false,
    "confidence": "medium",
    "source": "stub"
  },
  "meta": {
    "serviceKey": "nexa.geo.ip",
    "cached": true,
    "latency_ms": 4
  }
}