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

https://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 https://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 kép (0% kész)
The queue is being uploaded, it should take just a few seconds to complete.
Feltöltés befejezve
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 kép have been uploaded
Hiba történt és a rendszer nem tudta feldolgozni a kérést.
    Megjegyzés: Néhány kép nem került feltöltésre. tudjon meg többet
    További információért ellenőrizze a hibajelentést.
    JPG PNG BMP GIF WEBP 500 KB