Image Hosting, Upload Image and Share

API v1 ของ Freeimage.host อนุญาตให้อัปโหลดรูปภาพได้

คีย์ API

การเรียก API

วิธีการคำขอ

การเรียก API v1 สามารถทำได้ด้วยวิธี POST หรือ GET แต่เนื่องจากคำขอแบบ GET ถูกจำกัดด้วยความยาวสูงสุดของ URL คุณควรใช้วิธี POST เป็นหลัก

URL ของคำขอ

พารามิเตอร์

คีย์ (จำเป็น) คีย์ API
การดำเนินการ สิ่งที่คุณต้องการทำ [ค่า: upload].
แหล่งที่มา เป็น URL ของรูปภาพหรือสตริงรูปภาพที่เข้ารหัสแบบ base64 ก็ได้ คุณยังสามารถใช้ FILES["source"] ในคำขอของคุณได้ด้วย
รูปแบบ ตั้งค่ารูปแบบผลลัพธ์ [ค่า: json (ค่าเริ่มต้น), redirect, txt].

ตัวอย่างการเรียก

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

หมายเหตุ: ให้ใช้ POST เสมอเมื่ออัปโหลดไฟล์ภายในเครื่อง การเข้ารหัส URL อาจเปลี่ยนแปลงแหล่งข้อมูล base64 เนื่องจากอักขระที่ถูกเข้ารหัสหรือเนื่องจากข้อจำกัดความยาวของ URL จากคำขอแบบ GET

การตอบกลับของ API

การตอบกลับของ API v1 จะแสดงข้อมูลรูปภาพที่อัปโหลดทั้งหมดในรูปแบบ JSON

ในการตอบกลับแบบ JSON จะมีรหัสสถานะในส่วนหัวเพื่อให้คุณสังเกตได้ง่ายว่าคำขอสำเร็จหรือไม่ นอกจากนี้ยังจะแสดง สถานะ คุณสมบัติ.

ตัวอย่างการตอบกลับ (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"
}