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

AscArt

Конвертер картинок в ASCII.

ASCII (англ. American Standard Code for Information Interchange - американский стандартный код для обмена информацией) - представляет собой кодировку для представления десятичных цифр, латинского и национального алфавитов, знаков препинания и управляющих символов. Каждый символ имеет свой числовой код. В понимании ASCII Art поразумевается использование печатных символов для вывода изображений, а не самих ASCII-кодов.

Параметры

Имя параметра Тип Обязательный Описание
FILE1 Файл Да, если не указан URL Графический файл, из которого необходимо сделать ASCII. Допускаются файлы в формате: .jpg, .jpeg, .gif, .png и .bmp.
URL Строка Да, если не указан FILE1 Ссылка на графический файл.
FORMAT Строка Нет Формат: TEXT (по умолчанию), HTML (фиксированные пробелы -  ). При значении HTML, параметр CHARS игнорируется.
COLOR Строка Нет Цвет: BLACKWHITE (черно-белый, по умолчанию), GRAY (оттенки серого), COLOR (цветной). Если значение установлено GRAY или COLOR, то сервер вернет данные в формате HTML с использованием указанных CHARS.
CHARS Строка Нет Набор ASCII-символов. Только если FORMAT = TEXT. Первый символ будет черным, а последний - белым. Чем больше символов, тем больше цветов. Значение по умолчанию: #, # (это не опечатка), @, %, =, +, *, :, -, ., пробел.
Если FORMAT = HTML, то данный параметр игнорируется.
SIZE Целое число Нет Размер изображения. Крупные изображения могут содержать очень большое количество символов. Крупные (более 500px - хотя это тоже много) изобаржения будут уменьшены автоматически. Значение по умолчанию: 500.



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

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




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

Состояние: Работает
Использование: Бесплатно
Всего запросов: 61232
Запросов сегодня: 0
Первый запрос: 16.09.2012 11:21:13
Последний запрос: 23.05.2015 23:06:23