Image Hosting, Upload Image and Share

API v1 Freeimage.host اجازهٔ بارگذاری تصاویر را می‌دهد.

کلید 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 ممکن است به دلیل نویسه‌های کدگذاری‌شده یا محدودیت طول درخواست GET، منبع base64 را تغییر دهد.

پاسخ API

پاسخ‌های API v1 تمام اطلاعات تصویر بارگذاری‌شده را در قالب JSON نمایش می‌دهند.

در JSON پاسخ، هدرها دارای کد وضعیت خواهند بود تا به‌راحتی متوجه شوید درخواست موفق بوده است или نه. همچنین خروجی می‌دهد status ویژگی‌ها.

پاسخ نمونه (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"
}