Codificatore basi DNA

Le sequenze che contengono lettere diverse da A, C, G e T, o la cui lunghezza non è un multiplo di quattro, restituiscono un errore invalid_input chiaro invece di inventare padding o sostituzioni silenziose. Il percorso è aritmetica puramente deterministica su byte UTF-8 —senza rete, senza semi casuali, senza dipendenza dall'orologio— così che l'esecutore gratuito del browser e l'API prepagata restituiscano lo stesso JSON ogni volta che Lei la chiama a $0.002 per richiesta riuscita.

Come chiamare l'API e cosa contiene la risposta

La modalità predefinita è encode: i byte UTF-8 del testo diventano una stringa DNA continua in maiuscolo. La modalità decode tratta il testo come una sequenza DNA —eventualmente con spazi o separatori comuni— e restituisce la stringa UTF-8 recuperata dopo aver rimosso i separatori, portato le basi in maiuscolo e convalidato alfabeto e lunghezza. In caso di successo per decode, la risposta include mode, input, result e text con la stringa UTF-8 decodificata, dna normalizzata a sequenza continua maiuscola, gli stessi array groups e bytes, i conteggi, il mapping e un messaggio corrispondente. Invii un corpo JSON con un campo stringa obbligatorio text (alias input, value, data e sequence) e un mode opzionale che sia encode o decode. La lunghezza dell'input è limitata a centomila caratteri così una sola richiesta non esaurisce la memoria del Worker su stringhe enormi. In caso di successo per encode, la risposta include mode, input, result e dna con la stessa stringa di basi, groups come array di blocchi da quattro basi (uno per byte), bytes con i valori interi, byte_count, base_count, bit_count, la legenda del mapping e un breve messaggio. La convalida fallita —text assente, text non stringa, input troppo grande, mode sconosciuto, carattere non base, lunghezza non multiplo di quattro, oppure byte decodificati non UTF-8 validi— restituisce invalid_input e non viene mai addebitata. Il prezzo è una tariffa fissa di $0.002 per richiesta riuscita con unità item.

Suggerimenti pratici, limiti e strumenti correlati

I controlli andata e ritorno sono lo smoke test più rapido: codifichi una parola breve come Hi, confermi che le otto basi corrispondono ai gruppi di quattro basi noti per H e i, poi decodifichi quelle basi e confermi di recuperare la stringa originale. Preferisca questa capacità quando l'intento di ricerca è testo o binario versus basi DNA con tabella di impacchettamento a due bit; usi un convertitore testo-binario o esadecimale quando le servono forme zero-uno o esadecimali invece di A/C/G/T. Nell'insegnamento, mostri lo stesso emoji o lettera accentata accanto a una lettera ASCII semplice così gli studenti vedono gli ottetti UTF-8 multi-byte apparire come gruppi extra di quattro basi piuttosto che come un singolo codone misterioso. Preferisca decode quando ha già una stringa A/C/G/T da un manuale o da un payload generato e vuole recuperare i caratteri. Invii di proposito un frammento di tre basi o una stringa con X o U per verificare che il suo client gestisca invalid_input e il messaggio di errore che nomina l'alfabeto o la regola del multiplo di quattro. Mantenga i payload sotto il limite di caratteri pubblicato; i dump da più megabyte appartengono all'offline. Questo strumento non è un'utilità biologica di reverse-complement, né un traduttore di codoni, né un convertitore generale in base 4 per interi arbitrari: quei problemi meritano pagine dedicate. Le attività fallite che restituiscono invalid_input non consumano il saldo prepagato, il che mantiene economici gli script esplorativi quando gli apprendisti incollano sequenze incomplete.