Image Hosting, Upload Image and Share

Freeimage.host का API v1 तस्वीरें अपलोड करने की अनुमति देता है.

API Key

API कॉल

अनुरोध विधि

API v1 कॉल POST या GET अनुरोध विधियों का उपयोग करके की जा सकती हैं, लेकिन GET अनुरोध URL की अधिकतम अनुमत लंबाई से सीमित होते हैं, इसलिए आपको POST अनुरोध विधि को प्राथमिकता देनी चाहिए.

अनुरोध URL

पैरामीटर्स

कुंजी (अनिवार्य) API कुंजी.
क्रिया आप क्या करना चाहते हैं [मान: upload].
स्रोत या तो एक इमेज URL या base64 एन्कोडेड इमेज स्ट्रिंग। आप अपने अनुरोध में FILES["source"] का भी उपयोग कर सकते हैं।
फ़ॉर्मेट रिटर्न फ़ॉर्मेट सेट करता है [मान: json (default), redirect, txt].

उदाहरण कॉल

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

नोट: लोकल फ़ाइलें अपलोड करते समय हमेशा POST का उपयोग करें. URL एन्कोडिंग एन्कोडेड अक्षरों के कारण base64 स्रोत को बदल सकती है या GET अनुरोध के कारण URL अनुरोध लंबाई सीमा से टकरा सकती है.

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"
}