Image Hosting, Upload Image and Share

Freeimage.host API v1 leidžia įkelti paveikslėlius.

API raktas

API užklausa

Užklausos metodas

API v1 užklausas galima siųsti naudojant POST arba GET metodus, tačiau kadangi GET užklausas riboja maksimalus URL ilgis, turėtumėte teikti pirmenybę POST metodui.

Užklausos URL

Parametrai

raktas (privalomas) API raktas.
veiksmas Ką norite daryti [reikšmės: upload].
šaltinis Paveikslėlio URL arba base64 užkoduota paveikslėlio eilutė. Savo užklausoje taip pat galite naudoti FILES["source"].
formatas Nustato grąžinimo formatą [reikšmės: json (numatytasis), redirect, txt].

Pavyzdinė užklausa

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

Pastaba: visada naudokite POST įkeldami vietinius failus. URL kodavimas gali pakeisti base64 šaltinį dėl koduotų simbolių arba dėl GET užklausos URL ilgio ribojimo.

API atsakymas

API v1 atsakymai JSON formatu pateikia visą apie įkeltą paveikslėlį surinktą informaciją.

JSON atsakyme bus antraščių būsenos kodai, kad galėtumėte lengvai pastebėti, ar užklausa buvo sėkminga, ar ne. Taip pat bus pateiktos status savybės.

Pavyzdinis atsakymas (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"
}