Este tópico fornece uma explicação clara da política de fallback para imagens e instruções sobre como usar o modo de depuração para uma melhor experiência de implementação.
Garantia de Disponibilidade de Imagem
Entendemos a importância crítica das imagens na experiência do usuário final. Para garantir que nunca haja uma interrupção na entrega de conteúdo, a API foi projetada para reverter automaticamente para a imagem original em qualquer cenário de falha. Seja devido a um erro de transformação, instabilidade temporária ou qualquer problema na implementação da API, seus usuários finais continuarão a ter uma experiência visual sem interrupções.
Debugging Simplificado
Para facilitar a detecção e resolução de problemas durante a fase de implementação da API, adicione a query string ?debug=true ao final da URL de imagem. Isso ativa o modo de depuração, que fornece visibilidade em tempo real dos erros.
Exemplo de Uso com Debug:
Para ativar o modo de depuração, simplesmente anexe ?debug=true à sua URL
Enviando um parâmetro não suportado para a api /convert:unsupported/ a ativando o modo de depuração como na URL abaixo, vamos receber o seguinte retorno de erro:
https://img.voidr.co/meu_projeto/convert:unsupported/fetch/https://images.unsplash.com/photo-1561336313-0bd5e0b27ec8
{"error":"convert format \"unsupported\" not available","details":null}
Atenção ao utilizar o modo de depuração!
Recomendamos o uso do modo de depuração apenas durante o desenvolvimento e testes, para não expor informações de erro em um ambiente de produção.