Image Hosting, Upload Image and Share

Freeimage.host API v1-ek argazkiak igotzea ahalbidetzen du.

API gakoa

API deia

Eskaera metodoa

API v1 deiak POST edo GET bidez egin daitezke, baina GET eskaerak URL baten luzera maximoak mugatzen dituelako, hobe duzu POST metodoa erabiltzea.

Eskaera URLa

Parametroak

gakoa (beharrezkoa) API gakoa.
ekintza Zer egin nahi duzun [balioak: upload].
iturburua Irudi baten URL bat edo base64 bidez kodetutako irudi kate bat. Zure eskaeran FILES["source"] ere erabil dezakezu.
formatua Itzulera-formatua ezartzen du [balioak: json (lehenetsia), redirect, txt].

Adibide-deia

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

Oharra: Beti erabili POST fitxategi lokalak igotzean. URL kodeketak base64 iturburua alda dezake kodetutako karaktereengatik edo GET eskaeraren luzera-mugek eraginda.

API erantzuna

API v1 erantzunek igotako irudiaren informazio guztia JSON formatuan bistaratzen dute.

JSON erantzunak egoera-kodeak jarriko ditu goiburuetan eskaera ondo joan den ala ez erraz antzemateko. Halaber bistaratu egingo du egoera propietateak.

Erantzun adibidea (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"
}