Visão Geral
Entendendo as Respostas da API
A API ByByBG retorna códigos de status HTTP padrão para indicar sucesso, erros, limites de upload e limites de taxa.
Dica:
Sempre implemente tratamento adequado de erros em produção para proporcionar uma experiência estável aos usuários.
STATUS CODES
Códigos HTTP Comuns
Code
Description
200
Remoção de fundo concluída com sucesso.
400
Requisição inválida ou arquivo de imagem ausente.
401
Chave de API ausente ou inválida.
403
Acesso negado.
413
O arquivo de imagem enviado é muito grande.
415
Formato de imagem não suportado.
429
Muitas requisições. Limite de taxa excedido.
500
Erro interno de processamento do servidor.
503
Serviço temporariamente indisponível.
LIMITS
Limites de Upload
- Tamanho máximo da imagem: 10MB
- Formatos suportados: PNG, JPG, JPEG, WEBP
- Formato de saída transparente: PNG
- As requisições da API podem estar sujeitas a limites de taxa.
- Imagens maiores podem exigir mais tempo de processamento.
TROUBLESHOOTING
Problemas Comuns e Soluções
Chave de API Inválida
Verifique sua chave de API e os cabeçalhos da requisição.
Imagem Muito Grande
Comprima ou redimensione a imagem antes do envio.
Erro de Rede
Verifique sua conexão com a internet e o status do servidor backend.
Limite de Taxa
Reduza a frequência das requisições ou atualize seu plano.
BEST PRACTICES
Recomendações para Produção
- Implemente tentativas automáticas para requisições com falha.
- Exiba mensagens de erro claras para os usuários.
- Valide os arquivos enviados antes de enviá-los.
- Comprima imagens grandes antecipadamente.
- Armazene em cache respostas bem-sucedidas quando possível.
- Monitore o uso da API e os limites de taxa.
ERROR RESPONSE
Exemplo de Resposta JSON de Erro
{
"success": false,
"error": "Invalid API key"
}Documentação Concluída
Agora você está pronto para integrar a API ByByBG em sites, aplicativos móveis, plataformas SaaS e sistemas de automação.