Image Hosting, Upload Image and Share

API v1 của Freeimage.host cho phép tải ảnh lên.

Khóa API

Gọi API

Phương thức yêu cầu

Các lệnh gọi API v1 có thể thực hiện bằng phương thức POST hoặc GET nhưng do phương thức GET bị giới hạn bởi độ dài URL tối đa cho phép nên bạn nên ưu tiên phương thức POST.

URL yêu cầu

Tham số

key (bắt buộc) Khóa API.
hành động Bạn muốn thực hiện gì [giá trị: upload].
nguồn Một URL hình ảnh hoặc chuỗi hình ảnh được mã hóa base64. Bạn cũng có thể sử dụng FILES["source"] trong yêu cầu của mình.
định dạng Đặt định dạng trả về [giá trị: json (mặc định), redirect, txt].

Ví dụ lệnh gọi

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

Lưu ý: Luôn dùng POST khi tải tệp cục bộ. Mã hóa URL có thể làm thay đổi nguồn base64 do các ký tự được mã hóa hoặc do giới hạn độ dài URL đối với yêu cầu GET.

Phản hồi API

Phản hồi API v1 hiển thị toàn bộ thông tin ảnh đã tải lên ở định dạng JSON.

Trong JSON phản hồi sẽ có mã trạng thái ở phần header để bạn dễ dàng nhận biết yêu cầu có OK hay không. Nó cũng sẽ xuất ra trạng thái thuộc tính.

Ví dụ phản hồi (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"
}