Goimg — лёгкий сервер для работы с изображениями

Введение

GoImg — это сервер для обработки изображений, написанный на языке Golang.

На данный момент реализована только функция загрузки одного файла.

Поддерживаются форматы JPEG, PNG и GIF.

Для работы требуется версия Go 1.18 или выше.

Особенности функционала

Каталог хранения файлов создаётся с использованием алгоритма MD5.

В настоящее время поддерживаются эскизы форматов JPEG и PNG, эскизы GIF пока не поддерживаются.

Установка

Чтобы установить GoImg, выполните команду:

go get github.com/laixhe/goimg

Получение изображения

Получить изображение можно по запросу:

GET /9d32e3c40efb0b749270695d5f0afdfc

Получить уменьшенную версию изображения (ширина = 300, высота = 100) можно по запросу:

GET /9d32e3c40efb0b749270695d5f0afdfc?w=300&h=100

Загрузка изображения

Загрузить изображение можно с помощью запроса POST:

POST /

Параметры формы: userfile.

Ответ сервера: JSON-объект, содержащий следующие поля: * success: true; * code: 200; * msg: «OK»; * version: «v0.1.1»; * data: объект, содержащий информацию об изображении: * size: размер файла в байтах; * mime: тип файла; * imgid: уникальный идентификатор изображения.

Пример ответа сервера:

{
	"success": true,
	"code": 200,
	"msg": "OK",
	"version": "v0.1.1",
	"data": {
		"size": 42445,
		"mime": "jpeg",
		"imgid": "9d32e3c40efb0b749270695d5f0afdfc"
	}
}

Получение информации об изображении

Получить информацию об изображении можно по запросам:

• GET /info?imgid=9d32e3c40efb0b749270695d5f0afdfc;
• GET /info?imgid=9d32e3c40efb0b749270695d5f0afdfc&w=300&h=100.

Ответ сервера совпадает с ответом при загрузке изображения.

Получение кода состояния

Получить код состояния можно по запросу: GET /statuscode.

Ответ сервера: JSON-объект с кодом состояния.