Errori e Limiti – Documentazione ByByBG
❌ Errori e Limiti

Errori e Limiti API

Comprendi i codici di stato API, i limiti di caricamento, i limiti di richieste e le soluzioni di troubleshooting per applicazioni di produzione.

PANORAMICA

Comprendere le Risposte API

L'API ByByBG restituisce codici di stato HTTP standard per indicare richieste riuscite, errori, limiti di caricamento e limiti di velocità.

Suggerimento: Gestisci sempre correttamente gli errori API nelle applicazioni di produzione per garantire stabilità e una migliore esperienza utente.
STATUS CODES

Codici di Stato HTTP Comuni

Code
Description
200
Sfondo rimosso con successo.
400
Richiesta non valida o file immagine mancante.
401
API Key mancante o non valida.
403
Accesso negato.
413
Il file immagine caricato è troppo grande.
415
Formato immagine non supportato.
429
Troppe richieste. Limite di velocità superato.
500
Errore interno di elaborazione del server.
503
Servizio temporaneamente non disponibile.
LIMITS

Limiti di Caricamento

  • Dimensione massima immagine supportata: 10 MB.
  • Formati supportati: PNG, JPG, JPEG e WEBP.
  • Formato di output trasparente: PNG.
  • Le richieste API possono essere soggette a limiti di velocità.
  • Caricamenti di grandi dimensioni possono aumentare il tempo di elaborazione.
TROUBLESHOOTING

Problemi Comuni e Soluzioni

🔐

API Key Non Valida

Controlla la tua API Key e gli header della richiesta prima di inviare la richiesta.

📦

Immagine Troppo Grande

Comprimi l'immagine prima del caricamento per ridurre la dimensione del file e migliorare la velocità.

🌐

Errore di Rete

Verifica la connessione Internet e la disponibilità del server backend.

Limite di Velocità

Riduci la frequenza delle richieste oppure aggiorna il tuo piano API.

BEST PRACTICES

Raccomandazioni per la Produzione

  • Utilizza meccanismi di retry per le richieste non riuscite.
  • Mostra messaggi di errore intuitivi per gli utenti.
  • Convalida i caricamenti prima di inviare i file.
  • Comprimi le immagini di grandi dimensioni prima del caricamento.
  • Memorizza nella cache le risposte riuscite quando possibile.
  • Monitora l'utilizzo API e i limiti di richieste.
ERROR RESPONSE

Esempio di Risposta JSON di Errore

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

Documentazione Completata

Ora sei pronto per integrare l'API ByByBG in siti web, applicazioni mobili, piattaforme SaaS e sistemi di automazione.