Image Hosting, Upload Image and Share

Freeimage.host:n API v1 mahdollistaa kuvien lähettämisen.

API-avain

API-kutsu

Pyyntömenetelmä

API v1 -kutsut voidaan tehdä POST- tai GET-pyynnöillä, mutta koska GET-pyyntöjä rajoittaa URL-osoitteen enimmäispituus, sinun kannattaa suosia POST-pyyntöä.

Pyyntöosoite

Parametrit

avain (pakollinen) API-avain.
toiminto Mitä haluat tehdä [arvot: upload].
lähde Joko kuvan URL-osoite tai base64-koodattu kuvadata merkkijonona. Voit myös käyttää FILES["source"] pyynnössäsi.
muoto Asettaa palautusmuodon [arvot: json (oletus), redirect, txt].

Esimerkkikutsu

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

Huom: Käytä aina POST-pyyntöä ladattaessa paikallisia tiedostoja. URL-koodaus voi muuttaa base64-lähdettä koodattujen merkkien vuoksi tai GET-pyynnön pituusrajan takia.

API-vastaus

API v1 vastaukset näyttävät kaikki ladatun kuvan tiedot JSON-muodossa.

JSON-vastauksessa on otsakkeissa tilakoodit, joiden avulla huomaat helposti, oliko pyyntö OK vai ei. Se tulostaa myös tila ominaisuudet.

Esimerkkivastaus (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"
}