Riferimento errori API BlueskyGuida completa alla risoluzione dei problemi con soluzioni

Riferimento completo per gli errori dell'API Bluesky. Trova soluzioni e risolvi problemi comuni di integrazione.

10 codici di errore
5 categorie
AT Protocol

Categorie di Errori

Autenticazione

3 errors

Limitazione di frequenza

2 errors

Moderazione

2 errors

Media

2 errors

Contenuto

1 error

Tutti i Codici di Errore

#Autenticazione

invalid tokenrefresh-token

La sessione Bluesky è scaduta. Riconnetti il tuo account Bluesky.

Soluzione:

La tua sessione Bluesky non è più valida. Bluesky usa l'autenticazione basata su sessione. Riconnetti il tuo account per stabilire una nuova sessione.

expiredrefresh-token

La sessione Bluesky è scaduta. Riconnetti il tuo account Bluesky.

Soluzione:

La tua sessione Bluesky è scaduta. Le sessioni durano tipicamente per un tempo limitato. Riconnetti il tuo account per ottenere un nuovo token di sessione.

unauthorizedrefresh-token

La sessione Bluesky è scaduta. Riconnetti il tuo account Bluesky.

Soluzione:

Autenticazione fallita. Ciò accade quando la tua sessione scade o non è valida. Vai nelle impostazioni dell'account e riconnetti il tuo account Bluesky.

#Limitazione di frequenza

rate limitretry

Limite di frequenza Bluesky raggiunto. Riprova tra qualche momento.

Soluzione:

Hai superato i limiti di frequenza di Bluesky. Attendi qualche minuto prima di riprovare. Bluesky applica limiti di frequenza per mantenere la qualità del servizio.

too many requestsretry

Limite di frequenza Bluesky raggiunto. Riprova tra qualche momento.

Soluzione:

Troppe richieste in poco tempo. Distanzia le tue richieste e implementa il backoff esponenziale. Il sistema riproverà automaticamente.

#Moderazione

blockeduser-error

Contenuto bloccato dalla moderazione di Bluesky. Consulta le linee guida della comunità Bluesky.

Soluzione:

Il tuo contenuto è stato bloccato dal sistema di moderazione di Bluesky. Consulta le linee guida della comunità Bluesky e assicurati che il tuo contenuto sia conforme alle loro politiche.

moderationuser-error

Contenuto bloccato dalla moderazione di Bluesky. Consulta le linee guida della comunità Bluesky.

Soluzione:

Contenuto contrassegnato dai filtri di moderazione. Evita di pubblicare spam, molestie o contenuti che violano le linee guida di Bluesky. Rivedi e modifica il tuo contenuto.

#Media

blob too largeuser-error

Il file media è troppo grande o non valido. Bluesky ha limiti rigorosi sulle dimensioni dei file.

Soluzione:

Bluesky ha una dimensione massima del file di 1MB per le immagini. Comprimi le tue immagini per soddisfare questo requisito. Usa strumenti come TinyPNG o ImageOptim.

blob invaliduser-error

Il file media è troppo grande o non valido. Bluesky ha limiti rigorosi sulle dimensioni dei file.

Soluzione:

Il tuo file media non è valido o è corrotto. Assicurati che la tua immagine sia un file JPG, PNG o WebP valido. Riesporta l'immagine e riprova.

#Contenuto

text too longuser-error

Il testo del post supera il limite di caratteri di Bluesky (300 caratteri).

Soluzione:

Bluesky ha un limite di 300 caratteri per post. Accorcia il tuo testo o dividilo in più post (un thread). Sii conciso e diretto.

Migliori Pratiche

Gestione degli Errori

  • Implementare logica di aggiornamento sessione
  • Gestire limiti di frequenza con backoff esponenziale
  • Validare contenuto rispetto alle linee guida della comunità
  • Comprimere immagini prima del caricamento

Suggerimenti per la Prevenzione

  • Mantenere post sotto 300 caratteri
  • Comprimere immagini sotto 1 MB
  • Seguire linee guida comunità Bluesky
  • Usare autenticazione basata su sessione

Hai Bisogno di Aiuto per Bluesky l'Integrazione?

La nostra API gestisce automaticamente gli scenari di errore con logica di riprova intelligente e registrazione dettagliata.