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.
Argumentos para tratar las consultas de códigos postales como algo de primer nivel
Las prioridades de un producto se ven en la estructura de precios y en la profundidad de la documentación mucho antes de que aparezcan en cualquier declaración explícita sobre lo que más importa. Un endpoint escondido en un nivel de precios inferior, o documentado en tres frases junto a una página totalmente detallada para una función estrella, comunica un hecho real sobre la prioridad interna, lo quiera alguien comunicar o no. Las consultas de código postal son una víctima habitual de este patrón: técnicamente disponibles, rara vez cuidadas y tratadas como una utilidad menor frente a la geocodificación completa.
Pusimos a propósito a las consultas de código postal el mismo precio que a cualquier otro endpoint, precisamente para evitar esa degradación silenciosa. Están cubiertas por la misma cuota diaria gratuita, se facturan a los mismos 0,0001 € por solicitud a partir de ahí o se incluyen en la misma clave Unlimited de 50 €, exactamente igual que la geocodificación, las consultas de IP, la zona horaria o la elevación. No hay un nivel con descuento que indique que las consultas postales se consideran menos valiosas, ni un nivel premium que indique lo contrario. Están al mismo nivel que todo lo demás, porque creemos que así debe ser.
Un precio igual es un punto de partida, no todo el argumento. La razón de fondo por la que las consultas de código postal merecen un trato de primera clase es que los datos subyacentes justifican de verdad la misma seriedad que cualquier otro tipo de datos de ubicación. Los sistemas postales no son una versión simplificada de la geocodificación. Son una categoría de estructura propia, que varía según el país en el formato, en el tamaño del área que cubre un solo código y en la medida en que el código se corresponde directamente con los límites administrativos. Hacerlo bien en varios países exige una atención real y constante, la misma que recibe por defecto una función estrella de geocodificación porque se da por hecho que es la importante.
Tratar un endpoint como de primera clase también significa que recibe el mismo nivel de documentación: ejemplos reales, una descripción clara de qué datos se devuelven y cómo se estructuran, y notas honestas sobre las limitaciones de cobertura por país en lugar de una afirmación general y vaga. Un endpoint documentado de forma escueta porque se supone sencillo tiende a seguir siendo sencillo justo en los aspectos que importan, porque nadie lo mira con suficiente atención como para notar dónde se queda corto.
Esto tiene una ventaja práctica que va más allá de la justicia en cómo repartimos la atención de ingeniería. Muchas aplicaciones reales (calculadoras de envío, comprobaciones de jurisdicción fiscal, validación de zonas de servicio) dependen más directamente de una resolución correcta del código postal que de una geocodificación completa a nivel de calle. Tratar las consultas postales como una función menor frente a la geocodificación invierte la dependencia real justo en las aplicaciones que más necesitan estos datos. Darles el mismo precio y la misma documentación no es un gesto simbólico. Se parece más a corregir un error de categoría que el resto del sector ha heredado en su mayoría sin examinarlo.