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

Screen

Метод позволяет загрузить изображение на сервер обмена графическими файлами. В основном предназначен для обмена скриншотами (снимками экранов).

Параметры

Имя параметра Тип Обязательный Описание
FILE1 Файл Да Графический файл (png, jpg или gif), который нужно загрузить на сервер. Максимальный размер файла не должен превышать 4 Мб.
DD Целое число Нет Количество минут, которое изображение будет храниться на сервере. Значение по умолчанию: 0 (ноль) - на усмотрение сервера. После 30 дней, с момента загрузки изображения, если к нему не было сделано ни одного обращения, файл изображения может быть автоматически удален с сервера. Параметр DD позволяет сократить срок хранения файла. Не используйте данный параметр, чтобы продлить срок хранения файла. Значение DD не может превышать 30 дней (43 200 минут) с момента даты загрузки изображения на сервер.
FORMAT Строка Нет Формат сохранения файла. Возможные значения: PNG (по умолчанию), JPEG, GIF, ORIGINAL (оставить без изменений).



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

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




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

Состояние: Работает
Использование: Бесплатно
Всего запросов: 4288
Запросов сегодня: 0
Первый запрос: 13.01.2013 16:16:41
Последний запрос: 16.09.2017 16:27:10


Условия использования

Служба предоставляется на условиях «КАК ЕСТЬ». 
Стабильность работы службы не гарантируется.
Все загруженные изображения хранятся на сервере порядка 
тридцати (30) дней, после чего могут быть автоматически удалены.
Служба не предназначена для постоянного хранения файлов.
Используя данную службу, вы понимаете и осознаете, 
что все загруженные файлы могут стать достоянием общественности.
FoxTools.ru не несет никакой ответственности за возможный ущерб, 
причинный кому-либо в результате использования данной службы.
FoxTools.ru оставляет за собой право удалять любые загруженные 
изображения по своему усмотрению без каких-либо уведомлений.