Image Hosting, Upload Image and Share

API v1 služby Freeimage.host umožňuje nahrávať obrázky.

Kľúč API

Volanie API

Metóda požiadavky

Volania API v1 je možné vykonať metódami POST alebo GET, ale keďže požiadavky GET sú obmedzené maximálnou povolenou dĺžkou URL, uprednostnite metódu POST.

URL požiadavky

Parametre

key (povinné) Kľúč API.
akcia Čo chcete urobiť [hodnoty: upload].
zdroj Buď URL obrázka alebo reťazec obrázka zakódovaný v base64. Vo svojej požiadavke môžete použiť aj FILES["source"].
formát Nastavuje návratový formát [hodnoty: json (predvolené), redirect, txt].

Príklad volania

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

Poznámka: Pri nahrávaní lokálnych súborov vždy používajte POST. URL kódovanie môže zmeniť zdroj base64 kvôli kódovaným znakom alebo obmedzeniu dĺžky URL pri požiadavke GET.

Odpoveď API

Odpovede API v1 zobrazujú všetky informácie o nahranom obrázku vo formáte JSON.

V JSON odpovedi budú hlavičky so stavovými kódmi, aby ste ľahko zistili, či bola požiadavka v poriadku alebo nie. Tiež vypíše stav vlastnosti.

Príklad odpovede (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"
}