Внимание! Запущено тестирование FoxTools API v2.0!
Если у вас возникнут каки-либо вопросы по работе с API, вы можете оставлять их на форуме группы FoxTools.ru.

HEX

Метод позволяет преобразовать данные в шестнадцатеричный вид (HEX) и обратно.

Шестнадцатеричная система счисления (HEX) – это позиционная система счисления по целочисленному основанию 16. В качестве шестнадцатеричных чисел используются цифры от 0 до 9 и латинские буквы от A до F. Значения чисел от 0 до 9 обычны, как и в десятичной системе, далее, от 10 до 16 используются буквы A-F, т.е. буква F = 16, далее 11 = 17, 12 = 18 и т.д и т.п.

Параметры

Имя параметра Тип Обязательный Описание
VALUE Строка Да Данные, которые нужно преобразовать в/из HEX.
ACTION Строка Да Действие, которое необходимо выполнить над VALUE. Возможные значения: ENCODE - кодировать в HEX; DECODE - декодировать из HEX.
FORMAT Строка Да, если ACTION=ENCODE Формат кодирования. Возможные значения:
  • HEX - обычный код (например: FF);
  • BASIC - код в формате (Visual) Basic (например: &HFF);
  • C - код в формате Си (например: 0xFF);
  • PASCAL - код в формате Паскаль (например: $FF);
  • ASM - код в формате ассемблера (например: FFh);
  • REGEX - код в формате регулярных выражений (например: \xFF);
  • RTF - код в формате RTF (например: \'FF);
  • SQL - код в формате SQL (например: 0xFFFF120B21...);
  • URL - код в формате URL (например: %FF).
PATTERN Строка Нет Шаблон подстановки. Используется только при преобразовании данных в шестнадцатеричный вид (ACTION=ENCODE). В шаблоне можно использовать следующие команды: {index} - порядковый номер конвертируемого символа (начиная с нуля); {hex} - шестнадцатеричный код символа. Другие символы останутся без изменений. Например, при шаблоне "arr[{index}] = {hex}; ", результат преобразования строки "fox" в шестнадцатеричный вид будет таким: arr[0] = 0x66; arr[1] = 0x6F; arr[2] = 0x78;
Значение по умолчанию: {hex}.
ISNUMERIC Логический Нет Указывает, что значение VALUE нужно обрабатывать как число. Значение по умолчанию: FALSE.
REMOVEUNHEX Логический Нет Используется только при декодировании (ACTION=DECODE) данных из шестнадцатеричного вида. Если значение данного параметра равно TRUE, то из VALUE будут удалены все лишние символы, не являющиеся шестнадцатеричным представлением. Например, входная строка: "0x46 0x6F ой 0x78 лишные символы 0x54 будут 0x6F0x6F ;;;;; 0x6C0x730x2E0x72 удалены 0x75", на выходе будет: "FoxTools.ru".
Значение по умолчанию: FALSE.
CP Строка Нет Строковое имя или числовой код кодовой страницы (кодировки). Например: windows-1251 или 1251 - кириллица Windows. Значение по умолчанию: windows-1251. Полный список поддерживаемых кодовых страниц можно получить при помощи метода Encodings.
Обратите внимание, при использовании некоторых кодировк (например: utf-8), на один символ может приходиться два байта.

Примечания

Если при кодировании (ACTION=ENCODE) с включенным параметром ISNUMERIC (ISNUMERIC=TRUE) в качестве VALUE указать не число, то сервер вернет ошибку.
Любые операции с включенным параметром ISNUMERIC (ISNUMERIC=TRUE) ограничивают значение VALUE в пределах 64-битного цлочисленного выражения. Если значение VALUE будет превышать 64-битное значение, сервер вернет ошибку.


Общие сведения

Все команды к API необходимо делать методом POST, на этот же адрес, на котором вы находитесь в данный момент (исключая корневой арес сайта). Тип содержимого (Content-Type) при запросах к API должен быть multipart/form-data.

Для доступа к API обязательно нужно передовать идентификатор и открытый ключ доступа, которые можно получить в личном кабинете на сайте http://foxtools.ru в свойствах подключенного к сервису сайта.

Параметры для доступа к API

Имя параметра Тип Обязательный Описание
ID Целое число Да Уникальный идентификатор сайта в системе.
KEY Guid Да Открытый ключ доступа к API.
CID Целое число Нет Пользовательский идентификатор. Данный параметр можно передавать, чтобы получать более детальную статистику использования сервера. Например, в этот параметр можно передавать идентификатор пользователя в вашей БД, чтобы знать, сколько раз пользователь использовал тот или иной сервис.
CGRP Целое число Нет Группа для пользовательских идентификаторов (CID). Вы можете использовать этот параметр для группировки статистических данных. Например, если в CID вы передаете идентификатор пользователя в вашей БД, то параметр CGRP может быть равен 1. Если в CID вы передаете идентификатор страницы на вашем сайте, то CGRP может быть равен 2. Таким образом, вы сможете выделять статистику для пользователей (CGRP = 1) и страниц (CGRP = 2).

Примечание. Регистр символов значения не имеет. Это касается любых параметров, как имен, так и значений.

Формат ответа

Выдача результата в API возможна в трех форматах: XML (по умолчанию), JSON, текстовой.
Для указания формата выдачи необходимо добавить к адресу страницы запроса имя желаемого формата, через слеш.

Например:
http://api.foxtools.ru/v1/Hex/xml
http://api.foxtools.ru/v1/Hex/json
http://api.foxtools.ru/v1/Hex/text




Дополнительная информация

Состояние: Работает
Использование: Бесплатно
Всего запросов: 280486
Запросов сегодня: 0
Первый запрос: 20.09.2012 15:52:44
Последний запрос: 23.04.2015 19:25:17