Image Hosting, Upload Image and Share

Freeimage.host se API v1 laat toe dat beelde opgelaai word.

API sleutel

API oproep

Versoekmetode

API v1 aanroepe kan met die POST of GET versoekmetodes gedoen word, maar aangesien GET versoeke beperk word deur die maksimum toegelate lengte van ’n URL, behoort jy die POST versoekmetode te verkies.

Versoek URL

Parameters

sleutel (vereis) Die API sleutel.
aksie Wat jy wil doen [waardes: upload].
bron Of 'n beeld URL of 'n base64 gekodeerde beeldstring. Jy kan ook FILES["source"] in jou versoek gebruik.
formaat Stel die terugkeerformaat [waardes: json (verstek), redirect, txt].

Voorbeeldaanroep

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

Let wel: Gebruik altyd POST wanneer jy plaaslike lêers oplaai. URL-kodering kan die base64-bron verander weens geënkodeerde karakters of weens die URL-versoeklengtelimiet van ’n GET versoek.

API antwoord

API v1 antwoorde vertoon al die opgelaaide beeldinligting in JSON formaat.

In JSON sal die antwoord kopstatuskodes hê sodat jy maklik kan sien of die versoek OK was of nie. Dit sal ook die status eienskappe.

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