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 მოთხოვნის 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"
}