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 בעת העלאת קבצים מקומיים. קידוד כתובת עשוי לשנות את מקור ה 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"
}