Image Hosting, Upload Image and Share

Freeimage.host API v1 şəkilləri yükləməyə imkan verir.

API açarı

API çağırışı

Sorğu metodu

API v1 çağırışları POST və ya GET sorğu metodları ilə edilə bilər, lakin GET sorğuları URL-in icazə verilən maksimum uzunluğu ilə məhdudlaşdığı üçün POST metoduna üstünlük verməlisiniz.

Sorğu URL-i

Parametrlər

açar (mütləqdir) API açarı.
fəaliyyət Nə etmək istəyirsiniz [dəyərlər: upload].
mənbə Ya şəkil URL ünvanı, ya da base64 ilə kodlaşdırılmış şəkil sətiri. Sorğunuzda FILES["source"]dən də istifadə edə bilərsiniz.
format Qaytarılacaq formatı təyin edir [dəyərlər: json (standart), redirect, txt].

Nümunə çağırış

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

Qeyd: Lokal faylları yükləyərkən həmişə POST istifadə edin. URL kodlaşdırması kodlaşdırılmış simvollara görə və ya GET sorğusunun URL uzunluq limiti səbəbilə base64 mənbəni dəyişə bilər.

API cavabı

API v1 cavabları yüklənən şəkil haqqında bütün məlumatları JSON formatında göstərir.

JSON cavabında sorğunun UĞURLU olub-olmadığını asanlıqla görmək üçün başlıq status kodları olacaq. Həmçinin status xüsusiyyətlərini də verəcək.

Nümunə cavab (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"
}