Guía de integración de Housing Market API

Las tablas de referencia, las descripciones de los puntos de conexión, los códigos de error y los ejemplos se generan a partir de la especificación de la API y se mantienen en inglés en todos los idiomas. Los nombres, parámetros y códigos son idénticos en todas partes.

Autenticación

Envíe su clave en el encabezado x-api-key de cada solicitud.

Mantenga la clave en su servidor. Nunca la incluya en una aplicación móvil, una página web o un repositorio público: cualquiera que la tenga puede usar su suscripción.

Una clave pertenece a un solo cliente. No la comparta con otra empresa; los términos lo prohíben y podemos ver desde dónde se usa una clave.

Una sola clave incluye todo su acceso: sus países y su plan. Cuando añade un país o pasa a un plan superior, se actualiza la misma clave; no recibe una nueva.

Una clave ausente, desconocida o revocada se rechaza con unauthenticated. Una clave válida usada desde una dirección no registrada se rechaza con ip_not_allowed. Una clave en pausa se rechaza con key_paused.

Ejemplo de solicitud

curl
curl -H "x-api-key: $HMA_API_KEY" \
  "https://api.housingmarketapi.com/v1/ping"