Versão API 1

API v1 permite fazer upload de imagens como convidado para Imagens Brasil. A API é praticamente o mesmo que a API do nosso roteiro Imagens Brasil anterior e será usado durante a transição para o futuro v2 API.

Chamada API

Request Method

chamadas API v1 pode ser feito usando o POST ou GET métodos de solicitação, mas desde solicitação GET são limitados pelo tamanho máximo permitido de uma URL que você deve preferir o método de solicitação POST.

Request URL

http://ap.imagensbrasil.org/api/1/(action)/ (se isso não funcionar tente remover -> "/")

Parametros

  • Chave API The API v1 key is 9c9dfe77cd3bdbaa7220c6bbaf7452e7
  • Ação O que você quer fazer [values: upload].
  • código Ou um URL de imagem ou uma base64 encode de imagem codificada. Você também pode usar FILES["source"] no seu pedido.
  • formato Define o formato de retorno [values: json (default), redirect, txt].

Exemplo Chamada

GET http://ap.imagensbrasil.org/api/1/upload/?key=9c9dfe77cd3bdbaa7220c6bbaf7452e7&source=http://somewebsite/someimage.jpg&format=json

Nota: Sempre use POST ao fazer upload de arquivos locais. codificação de URL pode alterar a fonte base64 devido a caracteres codificados ou apenas por solicitação de URL limite de comprimento devido ao pedido GET.

Response API

Respostas API v1 irá variar dependendo do formato parâmetro:

  • json Exibir todas as informações de imagem carregados em formato JSON. [default]
  • txt Retorna a URL da imagem direta em formato de text/plain.
  • redirect Redireciona para a URL visualizador de imagens.

Ao usar JSON a resposta terá códigos de status cabeçalhos para permitir que você observe facilmente se o pedido foi OK ou não. Ele também emite o status_txt e status_code 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://127.0.0.1/images/2014/06/04/example.png",
			"url_viewer": "http://127.0.0.1/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://127.0.0.1/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://127.0.0.1/images/2014/06/04/example.md.png"
			},
			"views_label": "views",
			"display_url": "http://127.0.0.1/images/2014/06/04/example.md.png",
			"how_long_ago": "moments ago"
		},
		"status_txt": "OK"
	}

Example Response (txt)

http://127.0.0.1/images/2014/06/04/example.png

Edit or resize any image by clicking the image preview
Edit any image by touching the image preview
You can add more images from your computer or add image URLs.
You can add more images from your device, take a picture or add image URLs.
Uploading 0 image (0% complete)
The queue is being uploaded, it should take just a few seconds to complete.
Upload complete
Uploaded content added to . You can create a new album with the content just uploaded.
Uploaded content added to .
You can create a new album with the content just uploaded. You must create an account or sign in to save this content into your account.
No image have been uploaded
Some errors have occured and the system couldn't process your request.
    or cancelcancel remaining
    Note: Some images couldn't be uploaded. learn more
    Check the error report for more information.
    JPG PNG BMP GIF 500 KB