Image Hosting, Upload Image and Share

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

API ključ

API poziv

Metod zahteva

Pozivi API v1 mogu se vršiti metodama POST ili GET, ali pošto su GET zahtevi ograničeni maksimalnom dužinom URL adrese, trebalo bi da date prednost POST metodi.

URL zahteva

Parametri

ključ (obavezno) API ključ.
akcija Šta želite da uradite [vrednosti: upload].
izvor Ili URL slike ili base64 kodiran niz slike. Takođe možete koristiti FILES["source"] u svom zahtevu.
format Postavlja format povratne vrednosti [vrednosti: json (podrazumevano), redirect, txt].

Primer poziva

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

Napomena: Uvek koristite POST pri otpremanju lokalnih datoteka. URL enkodiranje može izmeniti base64 izvor zbog kodiranih karaktera ili zbog ograničenja dužine URL zahteva kod GET zahteva.

API odgovor

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

JSON odgovor će imati status kodove u zaglavljima kako biste lako uočili da li je zahtev bio OK ili ne. Takođe će izbaciti status svojstva.

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