Flickr Base58エンコーダー＆デコーダー

Flickr Base58エンコーダーは、通常のUTF-8テキストや非負整数を、Flickrがflic.kr短縮リンクで広めた58文字のアルファベットへ写像し、Flickr Base58デコーダーはその対応を逆にたどって元のペイロードを復元します。このアルファベットは数字と英字を保持しつつ、ゼロ、大文字のO、大文字のI、小文字のl、つまり手書きメモ、印刷ラベル、共有URLを読む際に人が最も混同しやすい4字形を取り除き、小文字を大文字の前に並べます。これはBitcoin Base58の順序とは逆です。アルファベット外の文字には、黙った破損ではなく明確なinvalid_inputエラーが返ります。処理は純粋で決定的な算術であり、ネットワーク、乱数シード、時計への依存がないため、無料のブラウザランナーとプリペイドAPIは毎回同じJSONを返します。

Flickr Base58とは何か、Bitcoin Base58とどう違うのか

黙って置き換えれば別のペイロードを捏造することになり、短縮URL、フィクスチャ、自動テストにとって明確なエラーより悪い結果です。このランディングは、Flickr Base58エンコーダー、短縮URL Base58デコーダー、Flickrアルファベット変換を探す人を対象としています。

APIの呼び出し方とレスポンスの内容

デフォルトのmodeはencode、デフォルトのformatはtextで、textのUTF-8バイト列がFlickr Base58文字列になります。format integerは、encode時に非負の数字文字列（符号、空白、小数点なし）を期待し、Flickr Base58の短縮URL風トークンを返します。必須の文字列フィールドtext（別名input、value、data）、encodeまたはdecodeの任意のmode、textまたはintegerの任意のformatを含むJSONボディを送信します。mode decodeとformat textの組み合わせではtextをBase58ペイロードとして扱い、復元したUTF-8文字列を返します。decode時には整数を10進文字列として、安全な場合はJSON数値として返します。入力長は10万文字に制限されており、1回のリクエストが病的な大整数展開でWorkerのメモリを使い果たすことを防ぎます。textのencodeが成功すると、レスポンスにはmode、format、input、result、同じエンコード文字列を持つbase58、58文字すべてのFlickr定数を持つalphabet、flickrに設定されたalphabet_name、input_bytes、output_length、短い英語メッセージが含まれます。整数encodeのレスポンスでは、値が安全なJSON整数に収まる場合にnumber_stringとnumberが追加されます。decodeのレスポンスは同じalphabet系フィールドを反映し、input_lengthと、text＋output_bytesまたはnumber_string＋numberを返します。検証失敗、つまりtextの欠落、非文字列のtext、超過サイズの入力、未知のmodeやformat、無効なBase58文字、数字でない整数ペイロード、UTF-8として無効なデコード結果はinvalid_inputを返し、課金されることはありません。料金は成功リクエスト1件あたり一律$0.002で、単位はitem、限界単価はゼロです。

実践的なコツ、制限、FlickrをBitcoinより選ぶ場面

デコードリクエストに禁止文字、つまり数字のゼロ、大文字のO、大文字のI、小文字のlを意図的に含め、クライアントがinvalid_inputと、インデックスと除外字形を示すエラーメッセージを正しく処理することを確認してください。ペイロードは公開されている文字数制限内に収めてください。invalid_inputを返す失敗タスクはプリペイド残高を消費しないため、無効なアルファベット文字をファズする探索的スクリプトも安価に保てます。