Image Hosting, Upload Image and Share

API v1 servisa Freeimage.host omogućava otpremanje slika.

API ključ

API poziv

Metod zahtjeva

Pozivi API v1 mogu se izvršiti metodama POST ili GET, ali pošto su GET zahtjevi ograničeni maksimalnom dozvoljenom dužinom URL-a, trebalo bi da koristite POST metodu.

URL zahtjeva

Parametri

ključ (obavezno) API ključ.
akcija Šta želite da uradite [vrijednosti: upload].
izvor Ili URL slike ili base64 kodirani niz slike. Takođe možete koristiti FILES["source"] u svom zahtjevu.
format Podesite izlazni format [vrijednosti: json (podrazumijevano), redirect, txt].

Primjer poziva

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

Napomena: Uvijek koristite POST za otpremanje lokalnih datoteka. URL kodiranje može izmijeniti base64 izvor zbog kodiranih karaktera ili ograničenja dužine URL zahtjeva kod GET metode.

API odgovor

Odgovori API v1 prikazuju sve informacije o otpremljenoj slici u JSON formatu.

JSON odgovor će imati statusne kodove u zaglavljima kako biste lako primijetili da li je zahtjev OK ili ne. Takođe će ispisati status svojstva.

Primjer odgovora (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"
}