Codificatore e decodificatore Flickr Base58

Un codificatore Flickr Base58 mappa il comune testo UTF-8 o interi non negativi sull'alfabeto di cinquantotto caratteri che Flickr ha reso popolare con i link brevi flic.kr, e un decodificatore Flickr Base58 inverte quella corrispondenza restituendole il payload originale. Scelga encode per convertire testo in chiaro o un ID intero in stile fotografico in Flickr Base58, oppure decode per recuperare l'UTF-8 o l'intero; i caratteri fuori alfabeto restituiscono un chiaro errore invalid_input invece di una corruzione silenziosa.

Cos'è il Flickr Base58 e in cosa differisce dal Base58 Bitcoin

Lo schema di URL brevi di Flickr usa un ordinamento concreto: cifre da uno a nove, poi minuscole a-z senza l, poi maiuscole A-Z senza I e O.

Come chiamare l'API e cosa contiene la risposta

Invii un corpo JSON con un campo stringa obbligatorio text (alias input, value e data), un mode opzionale che può essere encode o decode e un format opzionale che può essere text o integer. La modalità predefinita è encode e il formato predefinito è text: i byte UTF-8 di text diventano una stringa Flickr Base58. La modalità decode con format text tratta text come payload Base58 e restituisce la stringa UTF-8 recuperata. Il formato integer si aspetta una stringa di cifre non negativa in codifica (senza segno, spazi o punto decimale) e restituisce un token in stile URL breve Flickr Base58; in decodifica restituisce l'intero come stringa decimale e, quando è sicuro, come numero JSON. La lunghezza dell'input è limitata a centomila caratteri, così una singola richiesta non può esaurire la memoria del Worker con un'espansione patologica di interi grandi. In caso di successo per la codifica text, la risposta include mode, format, input, result e base58 con la stessa stringa codificata, alphabet con la costante Flickr completa di cinquantotto caratteri, alphabet_name impostato su flickr, input_bytes, output_length e un breve messaggio in inglese. Le risposte di codifica integer aggiungono number_string e number quando il valore rientra in un intero JSON sicuro. Le risposte di decodifica rispecchiano gli stessi campi dell'alfabeto con input_length e con text più output_bytes oppure number_string più number. La convalida fallita (text mancante, text non stringa, input troppo grande, mode o format sconosciuto, carattere Base58 non valido, payload intero non numerico o byte decodificati non validi in UTF-8) restituisce invalid_input e non viene mai addebitata. Il prezzo è un fisso di $0.002 per richiesta riuscita con unità item e prezzo unitario marginale pari a zero.

Consigli pratici, limiti e quando preferire Flickr al Base58 Bitcoin

Preferisca il formato integer quando lavora con identificatori numerici in stile URL breve come gli ID foto e le serve l'ordinamento dell'alfabeto Flickr che usano i codici brevi con minuscole prima. Preferisca il formato text quando parte da UTF-8 leggibile e vuole una stringa Base58 che omette comunque 0, O, I e l ma segue l'ordine dei caratteri di Flickr invece di quello di Bitcoin. Codifichi un intero noto come uno due tre quattro cinque sei sette otto nove zero uno due, decodifichi il token e verifichi che la stringa decimale corrisponda. In didattica, codifichi la stessa frase con entrambi gli alfabeti uno accanto all'altro, così chi impara vede perché le stringhe differiscono pur eliminando entrambi gli stessi quattro glifi ambigui. Includa deliberatamente un carattere proibito (cifra zero, O maiuscola, I maiuscola o L minuscola) in una richiesta di decodifica per verificare che il suo client gestisca invalid_input e il messaggio di errore che indica l'indice e i glifi esclusi. Mantenga i payload sotto il limite di caratteri pubblicato; le stringhe estremamente lunghe si espandono come interi grandi ed è meglio dividerle o gestirle offline. Questo strumento non è un risolutore completo di link brevi: non segue i redirect flic.kr, non classifica gli host farm di Flickr e non convalida indirizzi Bitcoin o checksum Base58Check. I compiti falliti che restituiscono invalid_input non consumano saldo prepagato, il che mantiene economici gli script esplorativi quando testa caratteri fuori alfabeto.