VTB-Derby

Base URI

http://vtb-foot-bitrix.indee.ru/sport/soccer/derby

Загрузка фотографии в VK

POST /upload-vk

Загрузка фотографии с компьютера

POST /collage/upload-file

Создание коллажа

POST /collage/upload

POST /collage/upload-file

С учетом необходимых браузеров, для того чтобы вывести на страницу фотографию с компьютера требуется её сначала залить на сервер. В ответ он должен отдать полный адрес картинки для вставки на страницу.

Request parameters

file

string required

Содержимое выбранное на компьютере файла

Responses

200 OK

Ошибки (числовой код - тестовое описание )

1 – Пустой файл
2 – Превышен допустимый размер
3 - Файл не подходит по формату (разрешаем только JP(E)G/PNG)
4 - Не достаточное разрешение (пока ставим минимум 100x100)
5 - Отсутствуют необходимые параметры
Коды 6-9 пока зарезервированы
10 и далее, любые другие ошибки, которые могут возникнуть на сервере

Body

Загрузка фотографии

POST /collage/upload

Отправка данных на сервер о выбранной фотографии, масштабе и угле поворота, смещении. Обязательным является только параметр src. Значение по умолчанию для scale 1, для смещения и угла – 0.

Request parameters

src

string required

Полный путь до файла. Файл может быть как предварительно загружен на сервер, так и из соц. сети.

scale

number optional

Масштаб, 1 - без изменения

Example:

1

angle

number optional

Угол в радианах. Ноль совпадает с вертикальной осью. Отсчитывается вправо, т.е положительные значения соответсвуют повороту по часовой стрелке, отрицательные против часовой.

Example:

1

left

number optional

Смещение центра фотографии относительно центра маски по горизонтали. Измеряется в пикселях для неотмасштабированного изображения.

Example:

1

top

number optional

Смещение центра фотографии относительно центра маски по вертикали. Измеряется в пикселях для неотмасштабированного изображения.

Example:

1

team

number optional

0 – первая команда, 1 – вторая

Example:

1

place

number optional

0, 1 или 2 для каждой команды, три место.

Example:

1

Responses

200 OK

Ошибки (числовой код - тестовое описание )

1 – Пустой файл
2 – Превышен допустимый размер
3 - Файл не подходит по формату (разрешаем только JP(E)G/PNG)
4 - Не достаточное разрешение (пока ставим минимум 100x100)
5 - Отсутствуют необходимые параметры
Коды 6-9 пока зарезервированы
10 и далее, любые другие ошибки, которые могут возникнуть на сервере

Body

Создание коллажа

POST /upload-vk

Метод для загрузки фотографий на сервера VK

Request parameters

src

string required

Полный путь до картинки для загрузки на сервера vk

upload_url

string required

Адрес сервера вконтакте для загрузки фотографии

Example:

http://cs9231.vkontakte.ru/upload.php?act=do_add_posted&mid=6492]& hash=284b5d004f5524e8b781cc9ddfb75de1&rhash=5133711120e3156dbb8f4cb2069fb29f&swfupload=1

Responses

200 OK

Ошибки (числовой код - тестовое описание )

1 – Пустой файл
2 – Превышен допустимый размер
3 - Файл не подходит по формату (разрешаем только JP(E)G/PNG)
4 - Не достаточное разрешение (пока ставим минимум 100x100)
5 - Отсутствуют необходимые параметры Коды 6-9 пока зарезервированы
10 и далее, любые другие ошибки, которые могут возникнуть на сервере

Body

Загрузка в VK

Стандартный ответ сервера на AJAX запрос

Object

status

string

Статус обработки запроса сервером

Example:

"ok" or "error"

data

Object

Объект содержащий данные непосредственно запрашиваемые клиентом

src

string

Полный путь до залитой картинки на сервере

Example:

http://vtb-foot-bitrix.indee.ru/sport/soccer/derby/upload/collage/originals/146758908786754534564576.jpg

error

Object

Объект содержащий описание ошибки

code

number

Числовой код ошибки, позволяющий её идентифицировать

Example:

1

text

string

Текст ошибки

Example:

Файл превышает допустимый размер

Ответ сервера на запрос создания коллажа

Object

status

string

Статус обработки запроса сервером

Example:

"ok" or "error"

data

Object

Объект содержащий данные непосредственно запрашиваемые клиентом

team

string

Полный путь до коллажа на основе фотографии одной из команд с вставленным лицом

Example:

http://vtb-foot-bitrix.indee.ru/sport/soccer/derby/upload/collage/team/146758908786754534564576.jpg

sharing_url

string

Полный путь до страницы с коллажом

Example:

http://vtb-foot-bitrix.indee.ru/sport/soccer/derby/collage/{id коллажа}

full

string

Полный путь до колажа на сервере на основе картинки с двумя командами и вставленным лицом

Example:

http://vtb-foot-bitrix.indee.ru/sport/soccer/derby/upload/collage/full/146758908786754534564576.jpg

error

Object

Объект содержащий описание ошибки

code

number

Числовой код ошибки, позволяющий её идентифицировать

Example:

1

text

string

Текст ошибки

Example:

Файл превышает допустимый размер

Methods: Создание коллажа

Ответ серера на запрос сохранения фотографии на сервер

Object

status

string

Статус обработки запроса сервером

Example:

"ok" or "error"

data

Object

Объект содержащий данные непосредственно запрашиваемые клиентом

src

string

Полный путь до залитой картинки на сервере

Example:

http://vtb-foot-bitrix.indee.ru/sport/soccer/derby/upload/collage/originals/146758908786754534564576.jpg

error

Object

Объект содержащий описание ошибки

code

number

Числовой код ошибки, позволяющий её идентифицировать

Example:

1

text

string

Текст ошибки

Example:

Файл превышает допустимый размер

Methods: Загрузка фотографии с компьютера

Ответ сервера на запрос заливки фотографий на сервера VK

Object

status

string

Статус обработки запроса сервером

Example:

"ok" or "error"

data

Object

Объект содержащий ответ vk, надо просто его скопировать. Выглядит он как-то так: {“server”: ‘1’, “photos”: ‘1’, “hash”: ‘12345abcde’}

error

Object

Объект содержащий описание ошибки

code

number

Числовой код ошибки, позволяющий её идентифицировать

Example:

1

text

string

Текст ошибки

Example:

Файл превышает допустимый размер

Methods: Загрузка фотографии в VK