Image Hosting, Upload Image and Share

A API v1 do Freeimage.host permite enviar imagens.

Chave da API

Chamada de API

Método da requisição

As chamadas da API v1 podem ser feitas usando os métodos de requisição POST ou GET, mas como as requisições GET são limitadas pelo comprimento máximo permitido de uma URL, você deve preferir o método POST.

URL da requisição

Parâmetros

chave (obrigatória) A chave da API.
ação O que você quer fazer [valores: upload].
fonte Pode ser uma URL de imagem ou uma string de imagem codificada em base64. Você também pode usar FILES["source"] na sua requisição.
formato Define o formato de retorno [valores: json (padrão), redirect, txt].

Exemplo de chamada

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

Observação: sempre use POST ao enviar arquivos locais. A codificação de URL pode alterar a fonte base64 devido a caracteres codificados ou simplesmente pelo limite de comprimento da URL em requisições GET.

Resposta da API

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

Na resposta JSON, os cabeçalhos terão códigos de status para permitir que você perceba facilmente se a requisição foi OK ou não. Ela também exibirá as status 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"
}