Excluindo arquivos de mídia#
/v1/media
Para excluir um arquivo de mídia, você precisa executar uma solicitação DELETE
no método media
. A solicitação requer o identificador do arquivo a ser excluído. O ID do arquivo pode ser obtido de mensagens recebidas ou do upload de mídia.
O período de armazenamento de mídia é de 24 horas. Depois que esse período expirar, os dados da mídia serão excluídos automaticamente.
Request#
Para excluir um arquivo de mídia, você precisa fazer uma requisição em:
Observe que o host é
media.green-api.com
DELETE https://media.green-api.com/v1/media/media-id
Parâmetros de Requisição#
Parâmetro | Tipo | Obrigatório | Descrição |
---|---|---|---|
media-id | string | Sim | O identificador do arquivo a ser excluído. Contido nas mensagens de entrada e também pode ser recebido ao enviar mídia . |
Resposta#
Em caso de sucesso, o código HTTP 200
é retornado.
Exemplo de Resposta#
200 OK
{}
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.
Se o arquivo não for encontrado, um código HTTP 404 Not Found será retornado sem texto.
Exemplo de código Python#
import requests
url = "https://media.green-api.com/v1/media/f32bb4f9-850b-43c6-9b91-279831914c95"
payload = {}
headers = {
'Authorization': 'Bearer {{AuthToken}}'
}
response = requests.request("DELETE", url, headers=headers, data = payload)
print(response.text.encode('utf8'))