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.
Lista de IP permitidas
Una clave solo funciona desde la dirección IP registrada para ella. Usted registra una dirección al suscribirse.
Para saber qué dirección vemos, llame a GET /v1/ping desde su servidor. La respuesta la devuelve en el campo address. Registre esa dirección, no la de su oficina ni la de su portátil.
Una solicitud desde cualquier otra dirección se rechaza con ip_not_allowed, aunque la clave sea correcta. Se aceptan tanto direcciones IPv4 como IPv6.
Puede cambiar la dirección registrada en la consola. Los cambios quedan registrados y son limitados, así que registre la dirección de salida de un servidor estable y use una dirección de salida estática si trabaja con un proveedor de nube.
Si sus servidores están detrás de un proxy o de una puerta de enlace NAT, registre la dirección del proxy o de la puerta de enlace, porque esa es la dirección que vemos.
GET /v1/ping
Check your key and the address we see
Confirms that the key is accepted from the address the request came from, and echoes that address. Use it to check the IP you registered before you build anything else.
Parameters
No parameters.
Responses
| Status | Description | Error codes |
|---|---|---|
200 | The key is valid and the address is registered. | |
401 | The key is missing, unknown or revoked. | unauthenticated |
403 | The key is valid but this request is refused. | ip_not_allowed key_paused |
429 | A rate limit or a quota has been reached. | rate_limited quota_exceeded |
503 | The service cannot answer right now. | service_unavailable |