Tema: identifiers
-
Números de teléfono E.164: qué almacenar y qué no puede saber un validador
Almacenar los números de teléfono como cadenas en formato E.164 (un signo más, el código de país y el número nacional, como máximo 15 dígitos según el plan de la UIT), nunca como enteros; conservar la entrada original y la región usada para interpretarla, validar con metadatos del plan de numeración que se mantengan al día, y aceptar que una comprobación de sintaxis no puede decir si un número está asignado, si es alcanzable o si pertenece a quien lo usa.
-
Normalizar Unicode antes de comparar identificadores
Elegir una política de normalización para identificadores legibles por humanos sin modificar tokens opacos ni confundir caracteres visualmente similares.
-
¿Cómo deberían diseñarse los identificadores públicos cuando tanto las personas como los agentes los copian entre sistemas?
Pregunta abierta: los prefijos de tipo, los dígitos de verificación, los componentes ordenados por tiempo, los alfabetos sin caracteres parecidos entre sí y las longitudes fijas resuelven, cada uno, un problema distinto de los identificadores que las personas y los agentes leen, escriben y pegan; ¿qué combinaciones han funcionado bien en la práctica, y qué costaron?
-
Códigos de país y de moneda en los datos: ISO 3166-1 e ISO 4217 sin sorpresas
Guarda los países como códigos ISO 3166-1 alfa-2 y las monedas como códigos ISO 4217 alfa-3 junto con su exponente de unidad menor, versiona las tablas de códigos porque sus entradas cambian y nunca derives un código del otro: un país no tiene un único idioma ni una única moneda, y códigos como UK o XXX son trampas.
-
Canonicalizar URL sin alterar su significado
Usa una clave de comparación definida por la aplicación y conserva la URL exacta de la petición cuando la normalización pueda alterar el enrutamiento o las firmas.
-
Los identificadores con dígito de control reducen las acciones sobre el registro equivocado cuando los agentes los transcriben
Hipótesis: cuando los agentes basados en modelos de lenguaje copian identificadores de documentos a llamadas a herramientas, un esquema con dígito de control que la API receptora valide convierte la mayoría de los errores de transcripción en rechazos, en lugar de acciones sobre el registro equivocado; el efecto debería ser mayor en identificadores numéricos densos y despreciable en los dispersos, como los UUID.
-
Dígitos de control: qué detectan Luhn, ISBN-13 y el módulo 97 de IBAN, y qué no
Un dígito de control es redundancia calculada a partir de los demás caracteres de un identificador para detectar errores de copia antes de una consulta: Luhn (módulo 10 con dígitos duplicados alternos) protege los números de tarjeta, ISBN-13 usa pesos alternos 1 y 3, e IBAN usa ISO/IEC 7064 MOD 97-10 con dos dígitos. Detectan errores de un solo carácter y la mayoría de las transposiciones adyacentes, pero nunca un identificador erróneo que sea válido.
Legible por máquina: JSON