Cifrado afín

Cuando a comparte un factor con veintiséis, la solicitud falla con invalid_input porque la correspondencia no sería biyectiva.

Cómo funciona la correspondencia afín y qué contiene la respuesta

El cifrado trata cada letra latina como un número de cero a veinticinco, lo multiplica por la clave a, suma la clave b y reduce el resultado módulo veintiséis antes de escribir la letra de nuevo con su capitalización original. Las mayúsculas de la A a la Z y las minúsculas de la a a la z usan los mismos desplazamientos, de modo que las frases con capitalización mixta conservan su forma y solo cambia la identidad de las letras. Los dígitos, espacios, signos de puntuación, emoji y escrituras no latinas pasan sin cambios, así que los mensajes mantienen sus espacios y símbolos. El modo opcional mode es encrypt por defecto; encrypt y encode aplican la correspondencia directa, mientras que decrypt y decode la invierten. El descifrado recupera el texto en claro calculando un inverso modular a_inv tal que a·a_inv ≡ 1 mod 26, y evaluando después D(y)=a_inv·(y−b) mod 26 para cada letra. Envíe JSON con el campo de cadena obligatorio text con cualquier mensaje no vacío, el entero obligatorio a entre uno y veinticinco y coprimo con veintiséis, y el entero obligatorio b entre cero y veinticinco; los alias input, value, s y message sirven para el cuerpo, multiplier, key_a y alpha son alias de a, y shift, key_b y beta son alias de b. Si la operación tiene éxito, la respuesta incluye result con el texto transformado, mode normalizado a encrypt o decrypt, a y b que repiten las claves, a_inv con el inverso usado para descifrar, length igual al número de caracteres de la entrada, letters_transformed con el recuento de letras A–Z o a–z realmente transformadas, y method igual a affine para que los clientes puedan ramificar sin inspeccionar la forma de la respuesta. Entradas idénticas producen siempre un JSON idéntico, porque el proceso es aritmética modular pura, sin red, sin semilla aleatoria y sin reloj.

Reglas de validación, claves coprimas y errores frecuentes

Un text ausente, que no sea cadena o vacío provoca invalid_input y no se cobra en la API de prepago una vez que el motor rechaza la solicitud. La ausencia de a o b, claves no enteras, a fuera del rango de uno a veinticinco o b fuera del rango de cero a veinticinco también fallan con invalid_input. Los espacios, dígitos y signos de puntuación no se eliminan: solo las letras latinas participan en la sustitución, así que las cadenas con mucha puntuación devuelven igualmente un resultado completo con un letters_transformed menor.

Uso de la API, precios, flujos de trabajo en clase y límites prácticos

Recurra a la API de prepago de KIT cuando un backend, una función serverless, una plataforma de tutoría o un SDK necesite un contrato estable con saldo a $0.002 por elemento procesado con éxito; los fallos de validación nunca consumen saldo tras el rechazo. Quienes publican SDKs pueden conectar el campo result directamente a un botón de copiar, mientras que a, b, a_inv y method hacen que los ejemplos de OpenAPI se expliquen por sí solos. Mantenga las cargas en tamaños de texto razonables para una llamada de elemento en un isolate de Worker; esta herramienta es para mensajes y fragmentos, no para blobs binarios de varios megabytes.