Image Hosting, Upload Image and Share

Freeimage.host API v1 ļauj augšupielādēt attēlus.

API atslēga

API izsaukums

Pieprasījuma metode

API v1 izsaukumus var veikt, izmantojot POST vai GET pieprasījuma metodes, bet, tā kā GET pieprasījumiem ir URL maksimālais garuma ierobežojums, priekšroku vajadzētu dot POST pieprasījuma metodei.

Pieprasījuma URL

Parametri

atslēga (obligāti) API atslēga.
darbība Ko vēlaties darīt [vērtības: upload].
avots Vai nu attēla URL vai base64 kodēta attēla virkne. Pieprasījumā varat izmantot arī FILES["source"].
formāts Iestata atgriešanas formātu [vērtības: json (noklusējums), redirect, txt].

Piemēra izsaukums

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

Piezīme: vietējiem failiem vienmēr izmantojiet POST. URL kodēšana var mainīt base64 avotu kodēto rakstzīmju dēļ vai tikai GET pieprasījuma garuma ierobežojuma dēļ.

API atbilde

API v1 atbildes parāda visu augšupielādētā attēla informāciju JSON formātā.

JSON atbilde ietvers galvenēs ar statusa kodiem, lai jūs viegli pamanītu, vai pieprasījums bija OK vai nē. Tā arī izvadīs statuss īpašības.

Piemēra atbilde (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"
}