Image Hosting, Upload Image and Share

واجهة API v1 الخاصة بـ Freeimage.host تتيح رفع الصور.

مفتاح API

استدعاء API

طريقة الطلب

يمكن إجراء استدعاءات API v1 باستخدام طريقتي الطلب POST أو GET، ولكن نظرًا لأن طلبات GET محدودة بالطول الأقصى المسموح به لعنوان URL يجب تفضيل طريقة POST.

عنوان URL للطلب

المعلمات

المفتاح (إلزامي) مفتاح API.
الإجراء ما الذي تريد فعله [القيم: upload].
المصدر إما رابط للصورة أو سلسلة صورة مُرمَّزة بترميز 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 بسبب المحارف المُرمَّزة أو بسبب حد طول طلب 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"
}