Image Hosting, Upload Image and Share

Freeimage.host API v1 суреттерді жүктеуге мүмкіндік береді.

API кілті

API шақыруы

Сұрау әдісі

API v1 шақыруларын POST немесе GET әдісімен орындауға болады, бірақ GET сұраулары URL ұзындығымен шектелетіндіктен, POST әдісін таңдаған жөн.

Сұрау URL-і

Параметрлер

кілт (міндетті) API кілті.
әрекет Не істегіңіз келеді [мәндер: upload].
дереккөз Сурет 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 дерегін таңбалар кодталуына не 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"
}