El problema de las claves de API que nunca caducan
Una clave emitida hace años, que nunca se ha rotado y que hoy sigue siendo válida, no es una comodidad. Es un riesgo que nadie ha revisado de verdad en años.
Los códigos postales merecen más respeto del que reciben
Pide a una API de ubicación su lista de funciones y normalmente la encabeza la geocodificación, después vienen las consultas de IP, y los códigos postales aparecen en algún lugar cerca del final, descritos en una sola línea como si resolver un código postal a un lugar, o un lugar a su código postal, fuera una consulta trivial con una única respuesta obvia. No lo es. Los sistemas postales varían enormemente según el país: algunos codifican la jerarquía administrativa directamente en los dígitos, otros son alfanuméricos, algunos cubren una zona del tamaño de un barrio y otros una zona del tamaño de un país pequeño. Tratarlo como un endpoint de utilidad menor subestima cuánta estructura real hay detrás.
Creamos las consultas de códigos postales como un endpoint de primera categoría junto a la geocodificación, la IP, la zona horaria y la elevación, y no como un añadido de última hora a la respuesta de geocodificación. Tiene el mismo precio que cualquier otro endpoint: cubierto por la cuota diaria gratuita y, después, los mismos 0,0001 € por solicitud o la misma clave Unlimited de 50 € que todo lo demás. No hay un nivel aparte de "endpoints de utilidad" que trate las consultas postales como una función menor que merece un precio menor y, de forma implícita, menos atención de ingeniería.
Parte del motivo por el que los códigos postales se infravaloran es que parecen sencillos vistos desde un país donde el sistema es un número fijo de dígitos que corresponde limpiamente a una zona pequeña. Esa sencillez no se puede generalizar. Una consulta de códigos postales tiene que gestionar de verdad la variedad de formatos y significados administrativos que existen en los distintos países, no solo el patrón más familiar para quien creó la función. Una API que da por hecho en silencio que el formato postal de un país es el predeterminado y trata todo lo demás como un caso excepcional no ofrece realmente soporte global de códigos postales. Ofrece el sistema de un país con una cobertura limitada añadida a la fuerza.
Esto importa en la práctica de formas fáciles de pasar por alto hasta que causan un problema. Los cálculos de envío, las consultas de jurisdicción fiscal, las comprobaciones de zona de servicio y los precios regionales dependen de acertar con la capa de códigos postales, a menudo de forma más directa que de una geocodificación completa a nivel de calle. Un presupuesto de envío no suele necesitar una dirección con precisión de tejado. Necesita una región postal correcta, resuelta de forma coherente. Tratar eso como una función menor frente a la geocodificación completa invierte la dependencia real en muchas aplicaciones reales.
No afirmamos que los datos de códigos postales sean un problema resuelto a escala mundial, porque los sistemas postales cambian constantemente y la calidad de la cobertura varía de verdad según el país y según la regularidad con la que cada autoridad postal publica actualizaciones. Lo que decimos es que merecen la misma seriedad que cualquier otro endpoint: documentación de verdad, el mismo precio que todo lo demás y la misma expectativa de que siga funcionando correctamente, en lugar de ser el rincón del producto que nadie vuelve a revisar en cuanto técnicamente devuelve una respuesta.