Image Hosting, Upload Image and Share

API v1 služby Freeimage.host umožňuje nahrávání obrázků.

Klíč API

Volání API

Metoda požadavku

Volání API v1 lze provádět metodami POST nebo GET, ale protože požadavky GET jsou omezeny maximální povolenou délkou URL, měli byste upřednostnit metodu POST.

URL požadavku

Parametry

klíč (povinné) Klíč API.
akce Co chcete udělat [hodnoty: upload].
zdroj Buď URL adresa obrázku nebo řetězec obrázku kódovaný v base64. Ve svém požadavku můžete také použít FILES["source"].
formát Nastaví návratový formát [hodnoty: json (výchozí), redirect, txt].

Ukázkové volání

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

Poznámka: Při nahrávání místních souborů vždy používejte POST. URL kódování může změnit zdroj base64 kvůli kódovaným znakům nebo kvůli omezení délky URL u požadavku GET.

Odpověď API

Odpovědi API v1 zobrazují všechny informace o nahraném obrázku ve formátu JSON.

V odpovědi JSON budou stavy v hlavičkách, abyste snadno poznali, zda byl požadavek v pořádku, či nikoli. Dále vypíše stav vlastnosti.

Ukázková odpověď (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"
}