Enviando arquivos de mídia#

/v1/media

Para enviar imagens, vídeo, áudio e documentos, você deve primeiro enviá-los utilizando o método media. Após o upload, o identificador de mídia estará disponível, o qual deverá ser usado ao enviar mensagens com mídia.

O tamanho máximo dos dados enviados é 37 MB.

O período de armazenamento de mídia é de 24 horas.

Request#

Para enviar dados de mídia, você precisa realizar uma requisição em:

Observe que o host é media.green-api.com

POST https://media.green-api.com/v1/media
X-Gr-File-Extension: jpeg

binary-media-data

Os dados binários do arquivo a ser carregado devem ser colocados no campo payload da requisição.

Request Headers#

Título	Obrigatório	Descrição
`X-Gr-File-Extension`	Sim	A extensão do arquivo enviado, por exemplo `jpeg`

Resposta#

Em uma resposta bem-sucedida, o código HTTP 201 é retornado. O corpo da resposta contém o parâmetro id, que deve ser usado em enviar mensagens com mídia e no método receber mídia.

Parâmetros de Resposta#

Parâmetro	Tipo	Descrição
`media`	array	Array com identificadores de arquivos enviados

Arraymedia

Parâmetro	Tipo	Descrição
`id`	string	ID do arquivo enviado. O identificador recebido deve ser usado ao enviar mensagens com mídia

Exemplo de Resposta#

201 Created

{
    "media": [
        {
            "id": "f32bb4f9-850b-43c6-9b91-279831914c95"
        }
    ],
    "meta": {
        "api_status": "stable",
        "version": "2.0.1"
    }
}

Erros#

Para obter uma lista de erros comuns a todos os métodos, consulte a seção Erros padrão.

Em caso de erro, o código HTTP 400 é retornado com uma descrição detalhada do erro no corpo da resposta.

Exemplo de código Python#

import requests

url = "https://media.green-api.com/v1/media"

payload = "<file contents here>"
headers = {
  'Authorization': 'Bearer {{AuthToken}}',
  'X-Gr-File-Extension': 'jpeg'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text.encode('utf8'))