Edad de mascota a años humanos

Los resultados son deterministas y redondeados para pantallas estables en widgets, bots SMS y clientes API de prepago. Las especies no reconocidas fallan con invalid_input en lugar de inventar un multiplicador falso. El mismo módulo puro alimenta la ruta gratuita del navegador y la API a $0.002 por ítem exitoso, de modo que marketing y automatización no discrepen sobre un perro mediano de tres años.

Contrato de entrada, campos de respuesta y errores

Para especies que no son perro, size puede omitirse; si se envía, se valida contra el mismo enum pero no cambia la fórmula de la especie. Ejemplo: un perro mediano de tres años da quince más nueve más cinco, o veintinueve años humanos con un decimal. Un gato de cinco años da quince más nueve más doce, o treinta y seis años humanos. Envíe un cuerpo JSON con age_years como número finito positivo de años de calendario (alias age, years, pet_age) y species como uno de dog, cat, rabbit, horse, guinea_pig o hamster (alias animal, pet, kind). Cuando species es dog, size es obligatorio y debe ser small, medium, large o giant (alias dog_size, weight_class). El opcional decimals (alias precision) es un entero de cero a dos que controla el redondeo de human_years; el valor predeterminado es una cifra decimal para lecturas legibles. Falta de edad o especie, números no finitos, edades fuera del rango soportado y peticiones de perro sin size generan invalid_input antes de cualquier conversión. Las especies no reconocidas—incluidos nombres de raza en texto libre, etiquetas de fauna o erratas—también generan invalid_input con un mensaje que lista el conjunto soportado, para que el cliente muestre un error de formulario claro en lugar de un respaldo silencioso. En éxito el cuerpo repite age_years y species, incluye size cuando aplica, devuelve human_years redondeado half-up, una etiqueta method con la familia de tabla y una cadena formula breve con las constantes de segmento. Combine la respuesta con su propia copia de interfaz; este endpoint no emite consejo veterinario más allá de la conversión numérica y los campos formula.

Dónde aporta valor una API multi-especie de años humanos

Demostraciones de biología en aula y kits STEM pueden mostrar por qué las tablas no lineales superan el mito de los siete años sin montar una hoja de cálculo por animal. Las herramientas de ingreso en refugios y los embudos de seguros para mascotas necesitan un endpoint estable que convierta edades de perro, gato y animales pequeños sin desplegar calculadoras separadas por especie. Como la implementación es parse pura de nivel A, cada llamada exitosa cuesta el precio base publicado $0.002 sin tokens de modelo; la validación fallida no consume saldo. Mantenga las edades en rangos habituales de compañía, exija size para perros, rechace especies desconocidas con claridad y obtendrá números de etapa de vida reproducibles para páginas, SDK y workers de borde sin reinventar tablas de envejecimiento en cada idioma.