Инструменты кодирования

Данные редко путешествуют в исходном виде. Двоичные файлы превращают в текст, чтобы они пережили почту и JSON, а текст экранируют, чтобы он безопасно поместился в URL. Когда одна сторона кодирует, а другая декодирует иначе, появляются сломанные ссылки, испорченная кириллица или токены, которые больше не проходят проверку. В этой категории собраны бесплатные конвертеры, которые показывают, что именно изменилось и почему, и работают полностью в браузере, ничего не загружая.

Кодировщик и декодер Base64

Кодировщик и декодер Base64 переводит текст в Base64 и обратно, поддерживает стандартный и URL-безопасный алфавиты, переносы строк для MIME и PEM и корректно работает с UTF-8, чтобы кириллица и эмодзи не искажались. Он показывает прирост размера и переключается на шестнадцатеричный вид, если байты не являются текстом, — удобно для data URI, заголовков Basic-аутентификации и частей JWT.

URL-кодировщик и декодировщик

URL-кодировщик и декодировщик кодирует отдельное значение или целый адрес, превращает последовательности %XX обратно в читаемый текст и разбирает ссылку на хост, путь и параметры. Он находит некорректные последовательности и двойное кодирование, например пробел, ставший %2520, и при необходимости заменяет пробелы на плюсы.

Когда они нужны

Используйте их, когда ломается ссылка с поисковым запросом или перенаправлением, когда API получает будто бы испорченные параметры, когда нужно вручную прочитать токен или сертификат или встроить небольшую картинку как data URI. Точные байты с обеих сторон обычно показывают расхождение за секунды.

Кодирование — не защита

Base64 и процентное кодирование делают данные удобными для передачи, но не секретными. Обратить их может кто угодно, поэтому никогда не прячьте так пароли, токены или персональные данные. Для секретности нужно настоящее шифрование или подписанный токен, а секретам не место в URL.

Частые ошибки кодирования

Большинство ошибок вызывают одни и те же причины: декодирование base64url стандартным алфавитом, удаление выравнивания =, которого ждёт строгий декодер, двойное кодирование, из-за которого пробел превращается в %2520, encodeURI там, где нужен encodeURIComponent, или чтение байтов UTF-8 как Windows-1251, из-за чего кириллица превращается в «кракозябры». Сравнение входа и выхода рядом сразу показывает, с каким случаем вы имеете дело.

Краткий чек-лист кодирования

Перед кодированием выясните, какой формат ждёт другая сторона: стандартный или URL-безопасный Base64, с выравниванием или без, одно значение или целый URL, пробелы как %20 или +. Кодируйте ровно один раз, в момент, когда значение попадает в URL или данные, всегда используйте UTF-8 и декодируйте пример, чтобы убедиться, что обратное преобразование возвращает исходник. Держите под рукой несколько заведомо правильных примеров, чтобы за секунды проверить обновление библиотеки или фреймворка.

Разберитесь в деталях

Оба конвертера ведут к подробным руководствам о том, как работают кодировки, какие различия в выравнивании и алфавите чаще всего сбивают с толку и как исправить вывод, который не декодируется.

Совет: кодируйте значение один раз — там, где оно попадает в URL, заголовок или data URI, — и декодируйте один раз там, где оно выходит. Двойное кодирование — самая частая причина %2520 и испорченного Base64. Быстрая проверка: декодируйте значение один раз и посмотрите, не осталось ли в нём лишних символов % или =. Сохраните копию результата, чтобы сравнить его после следующего изменения.