JSON-экспорт прокси для интеграций и автоматизации
JSON подходит для систем, которым недостаточно одной строки реквизитов. Каждая прокси представляется объектом с именованными полями, а список — массивом. Это исключает спор о разделителях и позволяет добавить протокол, сроки, идентификаторы и управляющую ссылку без изменения смысла остальных полей.
Главное за минуту
- Массив объектов даёт каждому значению явное имя.
- Числовой порт хранится числом, а идентификаторы — согласованным типом.
- JSON в межсистемном обмене кодируется UTF-8.
- Секреты включаются только по явному разрешению пользователя.
Схема объекта прокси
Минимальный объект содержит protocol, host и port. Username, password, changeIpUrl, pid, eid и expiresAt добавляются как отдельные необязательные поля. Имена фиксируются в документации и не меняются при переключении языка интерфейса.
Типы и отсутствующие значения
Порт удобнее передавать числом, дату — согласованной строкой, а булевы параметры — true/false. Неизвестное значение либо опускают по схеме, либо используют null; пустая строка не должна одновременно означать неизвестно, отключено и отсутствует.
Экранирование и генерация
Генерируйте JSON библиотекой сериализации, а не ручной склейкой. Она корректно обработает кавычки, обратные слеши и управляющие символы. После генерации документ проверяется стандартным парсером и при необходимости — схемой интеграции.
Минимизация данных
По умолчанию экспортируйте только необходимые поля. Пароль и подписанная ссылка управления могут дать действующий доступ и требуют отдельной галочки, предупреждения и аудита. После завершения аренды управляющая ссылка должна перестать работать независимо от сохранённого файла.
Практический чек-лист
- 1Зафиксировать документированную схему полей.
- 2Сохранять типы числа, строки и boolean.
- 3Сериализовать стандартной JSON-библиотекой.
- 4Проверить результат парсером и схемой.
- 5Не включать пароль и управляющую ссылку по умолчанию.
Источники и документы
Материал подготовлен по первичным, официальным и техническим источникам. Формулировки статьи являются самостоятельным изложением.