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

Text

Метод определяет кодировку текста и позволяет преобразовывать текст из одной кодировки в другую.

Параметры

Имя параметра Тип Обязательный Описание
TEXT Строка Да Текст, кодировку которого нужно определить, либо преобразовать.
CP1 Строка Нет Строковое имя или числовой код кодовой страницы (кодировки) исходного текста. Например: windows-1251 или 1251 - кириллица Windows. Значение по умолчанию: определяется автоматически. Полный список поддерживаемых кодовых страниц можно получить при помощи метода Encodings.
CP2 Строка Нет Строковое имя или числовой код кодовой страницы (кодировки), в которую будет преобразован исходный текст. Если данный параметр не указан, на выходе будет предложен список возможных кодировок на выбор. Полный список поддерживаемых кодовых страниц можно получить при помощи метода Encodings.
DETECT Логический Нет Управляет опцией автоматического определения кодировки по тексту. При значении TRUE в результате запроса будет возвращен список определенных кодировок и часть текста, преобразованного в эти кодировки. Если не указана исходная кодировка (CP1), значение данного параметра всегда будет TRUE.
AV Логический Нет Позволяет снять ограничение со списка исходящих кодировок, в случаях, когда параметр CP2 не указан. Если параметр CP2 не указан, по умолчанию TEXT будет кодирован в следующие кодировки: windows-1251, iso-8859-1, koi8-r, utf-8, gb2312, ibm855, cp866, x-mac-cyrillic, ibm880, koi8-u, iso-8859-5. Это наиболее популярные кодовые страницы, и другие кодировки обычно не требуются. Установка параметра AV в значение TRUE снимает ограничение со списка исходящих кодировок и на выходе будут предложены варианты TEXT во всех существующих кодировках. Значение по умолчанию FALSE.

Примечания

Если параметры CP1 или CP2 не будут указаны, то метод вернет несколько вариантов фрагментов TEXT, перекодированного между разными кодировками.
Если параметры CP1 и CP2 указаны, то будет возвращает TEXT кодированный между указанными кодировками.


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

Все команды к 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/Text/xml
http://api.foxtools.ru/v1/Text/json
http://api.foxtools.ru/v1/Text/text




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

Состояние: Работает
Использование: Бесплатно
Всего запросов: 220096
Запросов сегодня: 0
Первый запрос: 23.09.2012 16:37:33
Последний запрос: 20.04.2015 22:15:16