Image Hosting, Upload Image and Share

API v1 Freeimage.host omogoča nalaganje slik.

API ključ

Klic API

Metoda zahteve

Klice API v1 lahko izvajate z metodama POST ali GET, vendar so GET zahteve omejene z največjo dovoljeno dolžino URL, zato raje uporabite metodo POST.

URL zahteve

Parametri

ključ (obvezno) Ključ API.
dejanje Kaj želite narediti [vrednosti: upload].
vir Bodisi URL slike ali niz slike, kodiran v base64. V svoji zahtevi lahko uporabite tudi FILES["source"].
format Nastavi povratni format [vrednosti: json (privzeto), redirect, txt].

Primer klica

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

Opomba: Pri nalaganju lokalnih datotek vedno uporabljajte POST. Kodiranje URL lahko spremeni izvorni base64 zaradi kodiranih znakov ali zaradi omejitve dolžine URL pri GET zahtevi.

Odziv API

Odzivi API v1 prikazujejo vse informacije o naloženi sliki v formatu JSON.

JSON odgovor bo imel statusne kode v glavi, da boste zlahka opazili, ali je bila zahteva v redu ali ne. Prav tako bo izpisal status lastnosti.

Primer odziva (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"
}