No toda pregunta sobre ubicación es realmente una pregunta de geocodificación. A veces lo único que una aplicación necesita de verdad es el código postal de una zona determinada, o la zona que cubre un código postal determinado, sin la resolución de direcciones más amplia que ofrece la geocodificación directa o inversa. /v1/postcode existe precisamente para esa pregunta más concreta, como endpoint dedicado propio y no como efecto secundario de una consulta más general.
Mantenerlo separado de /v1/forward y /v1/reverse importa por varias razones prácticas. Significa que la estructura de la solicitud se puede construir específicamente en torno a los parámetros de código postal, en lugar de adaptarla a partir de una estructura de dirección más amplia. Significa que la respuesta puede centrarse exactamente en lo que necesita una integración que solo usa códigos postales, sin campos de dirección adicionales que filtrar. Y significa que la documentación, disponible completa en /docs/postal-code-lookup/, puede explicar el comportamiento de los códigos postales por sí mismo y no como una subsección de una guía de geocodificación más larga.
La autenticación sigue las mismas reglas que en cualquier otro endpoint: una cabecera X-API-Key, una cabecera Authorization: Bearer, autenticación HTTP Basic con la clave como nombre de usuario o un parámetro de consulta, todos aceptados por igual. Los precios también son los mismos: se usa la misma cuota diaria gratuita, ya sea la de la red que hace la llamada o la de la clave, y, por encima de ella, los mismos 0,0001 € por solicitud en crédito prepago o la cobertura de un paquete Unlimited.
Las solicitudes por lotes funcionan aquí exactamente igual que en el resto de la plataforma: cada código postal o dirección enviado en una sola llamada cuenta como una solicitud, no la llamada en su conjunto. Un equipo que valida códigos postales de una lista grande de clientes puede enviar esa lista como un lote y contar con el mismo recuento por elemento que se aplica a cualquier otra operación masiva en My Geocode.
Tener un endpoint dedicado también hace más preciso el trabajo de compatibilidad de códigos postales en nuestros diecisiete hosts de compatibilidad, ya que los proveedores que ofrecen su propia consulta postal dedicada se pueden reproducir exactamente en lugar de aproximarse mediante una estructura de geocodificación más amplia.
Si tu aplicación solo necesita información de códigos postales y hasta ahora enviaba solicitudes de geocodificación más amplias solo para extraer ese campo, merece la pena pasar directamente a /v1/postcode. Está documentado por completo en /docs/postal-code-lookup/, junto con el resto de nuestra referencia de endpoints en /docs/.