Image Hosting, Upload Image and Share

API v1 serwisu Freeimage.host umożliwia przesyłanie obrazów.

Klucz API

Wywołanie API

Metoda żądania

Wywołania API v1 można wykonywać metodami POST lub GET, ale ponieważ żądania GET są ograniczone maksymalną dozwoloną długością adresu URL, preferuj metodę POST.

Adres URL żądania

Parametry

klucz (wymagany) Klucz API.
akcja Co chcesz zrobić [wartości: upload].
źródło Adres URL obrazu albo ciąg obrazu zakodowany w base64. Możesz także użyć FILES["source"] w swoim żądaniu.
format Ustawia format zwracania [wartości: json (domyślnie), redirect, txt].

Przykładowe wywołanie

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

Uwaga: zawsze używaj metody POST przy przesyłaniu plików lokalnych. Kodowanie adresu URL może zmienić źródło base64 z powodu zakodowanych znaków lub limitu długości adresu URL w przypadku żądania GET.

Odpowiedź API

Odpowiedzi API v1 pokazują wszystkie informacje o przesłanym obrazie w formacie JSON.

W odpowiedzi JSON znajdą się kody statusu w nagłówkach, aby łatwo zauważyć, czy żądanie było OK, czy nie. Zwróci także status właściwości.

Przykładowa odpowiedź (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"
}