Image Hosting, Upload Image and Share

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

API ključ

API poziv

Metoda zahtjeva

Pozivi API v1 mogu se vršiti metodama zahtjeva POST ili GET, ali pošto su GET zahtjevi ograničeni maksimalnom dozvoljenom dužinom URL-a, trebali biste preferirati metodu POST.

URL zahtjeva

Parametri

ključ (obavezno) API ključ.
akcija Šta želite da uradite [vrijednosti: upload].
izvor Ili URL slike ili base64 kodirani niz slike. Također možete koristiti FILES["source"] u svom zahtjevu.
format Postavlja формат povratne vrijednosti [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 pri otpremanju lokalnih datoteka. URL kodiranje može izmijeniti izvorni base64 zbog kodiranih znakova ili zbog ograničenja dužine URL zahtjeva kod GET zahtjeva.

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 bio OK ili ne. Također će izbaciti 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"
}