MapIssues — rest — issues — files

Файлы

Список файлов

GET /issues/{id}/files

Структура запроса:

GET /issues/85/files?token=puqw129npc074a

Ответ:

Статус: 200 — успешное выполнение

[{
	"id": 24,
	"fileType": {
		"id": 1,
		"type": "photos"
	},
	"order": 1,
	"name": "gallery_20140714_163807.jpg",
	"description": "Отправлено с ru.gs.geotasks.debug",
	"geom": null
},...]

// id файла, целое число
// тип файла, массив
// id типа, целое число
// тип, строка

// заказ, целое число
// название файла, строка
// описание файла, строка
// тип геометрии, строка

Добавление файла

POST /issues/{id}/files

Структура запроса:

POST /issues/35/files?token=puqw129npc074a

Пример запроса:

{
	"name": "error.png",
	"uuid": "p19dpvtgq31ig86mdeo11s9q1l6e3.png",
        "fileTypeId": 1,
	"description": "Описание",
	"geom": ""
}

// название файла, строка
// уникальное название файла, строка
// id типа файла, целое число
// описание, строка (необязательное поле)
// геометрия, geojson (необязательное поле)

Ответ:

Статус: 200 — успешное выполнение

{
	"id": 12,
	"fileType": {
		"id": 1,
		"type": "photos"
	},
	"order": 1,
	"name": "picture.png",
	"description": "",
	"geom": null
}

// id файла, целое число
// тип файла, объект
// id типа файла, целое число
// тип файла, строка

// порядковый номер, целое число
// название файла, строка
// описание, строка
// тип геометрии, строка

Типы файлов

GET /issues/files/types

Структура запроса:

GET /issues/files/types?token=puqw129npc074a

Ответ:

Статус: 200 — успешное выполнение

[{
	"id": 1,
	"name": "фотографии",
	"extensions": ["jpg","jpeg","png"],
	"type": "photos"
},...]

// id типа файла, целое число
// название файла, строка
// расширения, строка
// английское название, строка

Просмотр файла

GET /issues/{id}/files/{fileId}

Структура запроса:

GET /issues/209/files/13?token=puqw129npc074a

Возможные параметры запроса:

Структура запроса с дополнительными параметрами:

GET /issues/20970/files/3370?width=500&height=800&crop=false?token=puqw129npc074a

Ответ:

Статус: 200 — успешное выполнение

Просмотр файла по названию

GET /issues/{id}/files/{fileId}/{fileName}

Структура запроса:

GET /issues/209/files/13/picture.png?token=puqw129npc074a

Возможные параметры запроса:

Структура запроса с дополнительными параметрами:

GET /issues/20970/files/3370/filename.png?width=500&height=800&crop=false?token=puqw129npc074a

Ответ:

Статус: 200 — успешное выполнение

Удаление файла

DELETE /issues/{id}/files/{fileId}

Структура запроса:

DELETE /issues/35/files/2?token=puqw129npc074a

Ответ:

Статус: 200 — успешное выполнение

{
	"id": 2
}

Возможные статусы ответов сервера при ошибке:

Статус: 401 — необходима авторизация

Статус: 403 — доступ запрещен

Статус: 404 — не найдено

Статус: 500 — ошибка на сервере