Image Hosting, Upload Image and Share

API v1 Freeimage.host позволяет загружать изображения.

Ключ API

Вызов API

Метод запроса

Вызовы API v1 можно выполнять с помощью методов запросов POST или GET, но поскольку запросы GET ограничены максимальной допустимой длиной URL, следует отдавать предпочтение методу POST.

URL запроса

Параметры

key (обязательный параметр) Ключ API.
action Что вы хотите сделать [значения: upload].
source Либо URL изображения, либо строка изображения, закодированная в base64. Вы также можете использовать FILES["source"] в своем запросе.
формат Задает формат ответа [значения: json (по умолчанию), redirect, txt].

Пример вызова

GET http://freeimage.host/api/1/upload/?key=12345&source=https://somewebsite/someimage.jpg&format=json

Примечание: при загрузке локальных файлов всегда используйте POST. Кодирование URL может исказить источник base64 из-за кодируемых символов или из-за ограничения длины URL при запросе GET.

Ответ API

Ответы API v1 показывают всю информацию о загруженном изображении в формате JSON.

В ответе JSON будут заголовки со статус-кодами, чтобы вы легко могли понять, выполнен ли запрос успешно. Также будет выведено статус свойства.

Пример ответа (JSON)

{
	"status_code": 200,
	"success": {
		"message": "image uploaded",
		"code": 200
	},
	"image": {
		"name": "example",
		"extension": "png",
		"size": 53237,
		"width": 1151,
		"height": 898,
		"date": "2014-06-04 15:32:33",
		"date_gmt": "2014-06-04 19:32:33",
		"storage_id": null,
		"description": null,
		"nsfw": "0",
		"md5": "c684350d722c956c362ab70299735830",
		"storage": "datefolder",
		"original_filename": "example.png",
		"original_exifdata": null,
		"views": "0",
		"id_encoded": "L",
		"filename": "example.png",
		"ratio": 1.2817371937639,
		"size_formatted": "52 KB",
		"mime": "image/png",
		"bits": 8,
		"channels": null,
		"url": "http://freeimage.host/images/2014/06/04/example.png",
		"url_viewer": "http://freeimage.host/image/L",
		"thumb": {
			"filename": "example.th.png",
			"name": "example.th",
			"width": 160,
			"height": 160,
			"ratio": 1,
			"size": 17848,
			"size_formatted": "17.4 KB",
			"mime": "image/png",
			"extension": "png",
			"bits": 8,
			"channels": null,
			"url": "http://freeimage.host/images/2014/06/04/example.th.png"
		},
		"medium": {
			"filename": "example.md.png",
			"name": "example.md",
			"width": 500,
			"height": 390,
			"ratio": 1.2820512820513,
			"size": 104448,
			"size_formatted": "102 KB",
			"mime": "image/png",
			"extension": "png",
			"bits": 8,
			"channels": null,
			"url": "http://freeimage.host/images/2014/06/04/example.md.png"
		},
		"views_label": "views",
		"display_url": "http://freeimage.host/images/2014/06/04/example.md.png",
		"how_long_ago": "moments ago"
	},
	"status_txt": "OK"
}