Autenticación

Para usar la API de Place Analyzer, necesitas una

API Key que te identifica como cliente autorizado. Todas las peticiones deben incluir tu API Key en el header X-API-KEY.

Resumen Rápido

Elemento	Valor
Header	`X-API-KEY`
Formato	String alfanumérico
Valuation API	`https://api.placeanalyzer.com/valuation/v1`
Report API	`https://api.placeanalyzer.com/report/v1`

curl -X GET "https://api.placeanalyzer.com/valuation/valuation-request/abc-123" \
-H "X-API-KEY: tu_api_key_aqui"

Obtener tu API Key

El proceso de obtención de tu API Key es completamente automático.

Paso 1: Registro e Inicio de Sesión

Ve a dash.prueba.place-api.com
Regístrate o inicia sesión con tu cuenta.

Paso 2: Copiar tu API Key

Una vez dentro del dashboard, tu API Key se generará automáticamente y estará visible en la pantalla principal o en la sección de configuración.

API Key Única

Actualmente, se asigna una única API Key por cuenta. Esta clave te da acceso a todos los servicios disponibles.

API Key: pk_live_abc123xyz...

Usar la API Key

Incluye tu API Key en el header X-API-KEY de todas las solicitudes:

curl -X GET "https://api.placeanalyzer.com/valuation/valuation-request/abc-123-xyz" \
-H "X-API-KEY: tu_api_key_aqui" \
-H "Content-Type: application/json"

Servicios Disponibles

Place Analyzer ofrece dos servicios principales en su entorno de producción:

Servicio	URL Base	Uso
🏠 Valuation API	`https://api.placeanalyzer.com/valuation/v1`	Gestión de avalúos
📊 Report API	`https://api.placeanalyzer.com/report/v1`	Análisis de mercado

Un solo entorno

Ambos servicios operan en el entorno de producción y comparten la misma autenticación.

Errores de Autenticación

401 Unauthorized - API Key Inválida

{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "La API Key proporcionada no es válida o ha expirado"
  }
}

Causas comunes:

API Key incorrecta o mal copiada
API Key de sandbox usada en producción (o viceversa)

401 Unauthorized - API Key Faltante

{
  "error": {
    "code": "MISSING_API_KEY",
    "message": "Se requiere el header X-API-KEY"
  }
}

Solución: Incluir el header X-API-KEY en la petición.

403 Forbidden - Permisos Insuficientes

{
  "error": {
    "code": "INSUFFICIENT_PERMISSIONS",
    "message": "Tu API Key no tiene permisos para esta operación"
  }
}

Solución: Contactar soporte para habilitar permisos adicionales.

Seguridad: Mejores Prácticas

Nunca expongas tu API Key

Trata tu API Key como una contraseña. No la incluyas en código público ni la compartas.

✅ Usar Variables de Entorno

# Archivo .env (agregar a .gitignore)
PLACE_ANALYZER_API_KEY=pk_live_tu_api_key_aqui
PLACE_ANALYZER_ENV=production

# Para desarrollo
# PLACE_ANALYZER_API_KEY=pk_test_tu_api_key_sandbox
# PLACE_ANALYZER_ENV=sandbox

✅ Lista de Verificación de Seguridad

Práctica	Descripción
Variables de entorno	Nunca hardcodear la API Key en el código
`.gitignore`	Agregar archivos `.env` y de configuración
Monitoreo	Revisar uso anómalo en el dashboard

❌ Lo que NO debes hacer

// ❌ MAL: API Key hardcodeada
const API_KEY = 'pk_live_abc123xyz';

// ❌ MAL: API Key en el frontend expuesto
<script>
  const apiKey = 'pk_live_abc123xyz';
</script>

// ❌ MAL: API Key en repositorio público
// config.js
export const API_KEY = 'pk_live_abc123xyz';

✅ Lo que SÍ debes hacer

// ✅ BIEN: API Key desde variable de entorno
const API_KEY = process.env.PLACE_ANALYZER_API_KEY;

// ✅ BIEN: API Key en el backend, nunca en frontend
// Crear un endpoint proxy en tu servidor
app.post('/api/valuation', async (req, res) => {
  const response = await fetch('{VALUATION_API_URL}/valuation-request', {
    headers: { 'X-API-KEY': process.env.PLACE_ANALYZER_API_KEY },
    body: JSON.stringify(req.body)
  });
  res.json(await response.json());
});

Siguiente paso

Ya tienes tu API Key configurada. Ahora sigue con el

flujo básico de avalúo para crear tu primera tasación.