Errores y Límites – Documentación ByByBG
❌ Errores y Límites

Errores y Límites de la API

Comprende los códigos de estado de la API, las restricciones de carga, los límites de solicitudes y las soluciones para aplicaciones en producción.

RESUMEN

Comprender las Respuestas de la API

La API ByByBG devuelve códigos de estado HTTP estándar para indicar solicitudes exitosas, errores, restricciones de carga y límites de velocidad.

Consejo: Gestiona siempre los errores de la API correctamente en aplicaciones de producción para mejorar la estabilidad y la experiencia del usuario.
STATUS CODES

Códigos de Estado HTTP Comunes

Code
Description
200
Fondo eliminado correctamente.
400
Solicitud inválida o falta el archivo de imagen.
401
Clave API faltante o inválida.
403
Acceso denegado.
413
El archivo de imagen cargado es demasiado grande.
415
Formato de imagen no compatible.
429
Demasiadas solicitudes. Se excedió el límite permitido.
500
Error interno de procesamiento del servidor.
503
Servicio temporalmente no disponible.
LIMITS

Restricciones de Carga

  • Tamaño máximo de imagen permitido: 10 MB.
  • Formatos compatibles: PNG, JPG, JPEG y WEBP.
  • Formato de salida transparente: PNG.
  • Las solicitudes API pueden estar sujetas a límites de velocidad.
  • Las cargas grandes pueden aumentar el tiempo de procesamiento.
TROUBLESHOOTING

Problemas Comunes y Soluciones

🔐

Clave API Inválida

Verifica tu clave API y los encabezados de la solicitud antes de enviarla.

📦

Imagen Demasiado Grande

Comprime las imágenes antes de subirlas para reducir el tamaño del archivo y mejorar la velocidad.

🌐

Error de Red

Comprueba la conexión a Internet y la disponibilidad del servidor backend.

Límite de Solicitudes

Reduce la frecuencia de las solicitudes o actualiza tu plan API.

BEST PRACTICES

Recomendaciones para Producción

  • Utiliza mecanismos de reintento para solicitudes fallidas.
  • Muestra mensajes de error claros y amigables para el usuario.
  • Valida las cargas antes de enviar archivos.
  • Comprime imágenes grandes antes de subirlas.
  • Almacena en caché las respuestas exitosas cuando sea posible.
  • Supervisa el uso de la API y los límites de solicitudes.
ERROR RESPONSE

Ejemplo de Respuesta JSON de Error

{
  "success": false,
  "error": "Invalid API key"
}

Documentación Completa

Ahora estás listo para integrar la API ByByBG en sitios web, aplicaciones móviles, plataformas SaaS y sistemas de automatización.