Cifrario affine

Quando a condivide un fattore con ventisei, la richiesta fallisce con invalid_input perché la corrispondenza non sarebbe biiettiva.

Come funziona la corrispondenza affine e cosa contiene la risposta

La cifratura tratta ogni lettera latina come un numero da zero a venticinque, lo moltiplica per la chiave a, aggiunge la chiave b e riduce modulo ventisei prima di riscrivere la lettera con la capitalizzazione originale. Le maiuscole dalla A alla Z e le minuscole dalla a alla z usano gli stessi spostamenti, quindi le frasi con capitalizzazione mista mantengono la forma e cambia solo l'identità delle lettere. Cifre, spazi, punteggiatura, emoji e scritture non latine passano invariati, così i messaggi conservano spaziature e simboli. La modalità opzionale mode ha encrypt come valore predefinito; encrypt ed encode applicano la corrispondenza diretta, mentre decrypt e decode la invertono. La decifratura recupera il testo in chiaro calcolando un inverso modulare a_inv tale che a·a_inv ≡ 1 mod 26, e valutando poi D(y)=a_inv·(y−b) mod 26 per ogni lettera. Invii JSON con il campo stringa obbligatorio text contenente qualsiasi messaggio non vuoto, l'intero obbligatorio a tra uno e venticinque e coprimo con ventisei, e l'intero obbligatorio b tra zero e venticinque; gli alias input, value, s e message funzionano per il corpo, multiplier, key_a e alpha sono alias di a, mentre shift, key_b e beta sono alias di b. In caso di successo, la risposta include result con il testo trasformato, mode normalizzato a encrypt o decrypt, a e b che riportano le chiavi, a_inv con l'inverso usato per la decifratura, length pari al numero di caratteri dell'input, letters_transformed che conta quante lettere A–Z o a–z sono state effettivamente trasformate, e method uguale ad affine così i client possono diramare senza ispezionare la forma della risposta. Input identici producono sempre un JSON identico, perché il percorso è aritmetica modulare pura, senza rete, senza seme casuale e senza orologio.

Regole di validazione, chiavi coprime ed errori comuni

Un text mancante, non stringa o vuoto genera invalid_input e non viene addebitato sull'API prepagata dopo che il motore rifiuta la richiesta. La mancanza di a o b, chiavi non intere, a fuori dall'intervallo da uno a venticinque o b fuori dall'intervallo da zero a venticinque falliscono anch'essi con invalid_input. Spazi, cifre e punteggiatura non vengono eliminati: solo le lettere latine partecipano alla sostituzione, quindi le stringhe ricche di punteggiatura restituiscono comunque un risultato completo con un letters_transformed più basso.

Uso dell'API, prezzi, flussi di lavoro in classe e limiti pratici

Ricorra all'API prepagata di KIT quando un backend, una funzione serverless, una piattaforma di tutoraggio o un SDK ha bisogno di un contratto stabile con saldo a $0.002 per elemento elaborato con successo; i fallimenti di validazione non consumano mai saldo dopo il rifiuto. Chi pubblica SDK può collegare il campo result direttamente a un pulsante di copia, mentre a, b, a_inv e method rendono gli esempi OpenAPI autoesplicativi. Mantenga i payload a dimensioni di testo ragionevoli per una chiamata di elemento in un isolate di Worker; questo strumento è per messaggi e frammenti, non per blob binari di diversi megabyte.