Image Hosting, Upload Image and Share

A API v1 de Freeimage.host permite enviar imagens.

Chave da API

Chamada à API

Método do pedido

As chamadas da API v1 podem ser feitas utilizando os métodos de pedido POST ou GET, mas como os pedidos GET são limitados pelo comprimento máximo permitido de um URL, deve preferir o método POST.

URL do pedido

Parâmetros

chave (obrigatória) A chave da API.
ação O que pretende fazer [valores: upload].
fonte Um URL de imagem ou uma string de imagem codificada em base64. Também pode usar FILES["source"] no seu pedido.
formato Define o formato de retorno [valores: json (predefinido), redirect, txt].

Exemplo de chamada

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

Nota: Use sempre POST ao carregar ficheiros locais. A codificação da URL pode alterar a fonte base64 devido a caracteres codificados ou simplesmente pelo limite de comprimento do pedido GET.

Resposta da API

As respostas da API v1 exibem todas as informações da imagem enviada em formato JSON.

No JSON a resposta terá códigos de estado nos cabeçalhos para permitir que note facilmente se o pedido foi OK ou não. Também irá apresentar o estado propriedades.

Exemplo de resposta (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"
}