Aggiungere una cartella ai preferiti

Il modello dati attuale supporta cartelle preferite personali, ma i menu dei file web e mobile esaminati non offrono Aggiungi ai preferiti per le cartelle. Usa un gruppo personale per operare interamente con l’interfaccia grafica. Gli utenti esperti possono creare il riferimento alla cartella tramite API REST.

Una cartella preferita fa riferimento alla cartella esistente. Non ne copia il contenuto, non cambia la cartella superiore, non occupa altro spazio di archiviazione e non concede accesso ad altri.

Prima di iniziare

• Preferisci Aggiungi al gruppo se ti serve un collegamento solo nel client. I gruppi sono disponibili per le cartelle nei menu dei file su browser e mobile.
• Per la route POST procurati l’ID dello spazio di lavoro e l’ID della cartella attiva. Usa una chiave API bearer con ambito full, accesso API e vincolo allo stesso spazio di lavoro; gli ambiti limitati read, upload, clipper o wp_site non possono eseguire questa POST.
• Il proprietario della chiave deve essere un membro dello spazio di lavoro senza restrizione a cartelle. POST verifica appartenenza, visibilità della destinazione e catena di blocchi completi che la contiene, ma non richiede il permesso del ruolo per la pagina File.
• La lettura è più restrittiva: GET /api/favourites rifiuta un membro confinato e richiede accesso alla pagina File prima di restituire le righe visibili e sbloccate.
• Tieni la credenziale fuori dalla cronologia del terminale, dagli screenshot e dai messaggi all’assistenza.

Passaggi

1. Inserisci il segreto in una variabile d’ambiente protetta e invia questa richiesta con i tuoi identificativi reali:

   curl --fail-with-body --request POST "https://api.dosya.dev/api/favourites" \
     -H "Authorization: Bearer $DOSYA_API_KEY" \
     -H "Content-Type: application/json" \
     --data '{"workspace_id":"ws_...","folder_id":"fld_..."}'

2. La prima aggiunta riuscita restituisce HTTP 201 con un oggetto contenente ok: true e l’ID della nuova riga dei preferiti.

3. Verifica con GET /api/favourites?workspace_id=ws_… Se il ruolo ha accesso alla pagina File, l’oggetto corrispondente compare nell’array folders con folder_id, folder_name, ID della cartella superiore e ora di creazione effettivi.

4. Su mobile, Impostazioni → Preferiti può mostrare le righe delle cartelle restituite dall’API. La barra laterale nel browser legge attualmente solo l’array files della risposta e non mostra quindi la cartella.

5. Apri la cartella da mobile o dal normale percorso in File e controlla il percorso di navigazione e il contenuto originali.

Una seconda POST per lo stesso account e la stessa cartella restituisce HTTP 409 con “Already in favourites.” Una destinazione sconosciuta o nascosta risponde “Folder not found.” Un blocco completo che la contiene produce “folder_locked” e una credenziale vincolata a un altro spazio di lavoro riceve “This API key is pinned to a different workspace.”

Risultato previsto

Il server memorizza una riga personale dei preferiti per la cartella, che resta nella posizione precedente con contenuto e permessi invariati. Chi supera i controlli GET di appartenenza e accesso a File può leggerla e mobile può mostrarla; la barra laterale attuale del browser non può.

La rimozione è reversibile e riguarda solo il riferimento: chiama DELETE /api/favourites con gli stessi workspace_id e folder_id, poi esegui di nuovo POST se vuoi ripristinarlo.

Risoluzione dei problemi

Non c’è una stella per la cartella in File. È il comportamento previsto del client attuale. Scegli Aggiungi al gruppo o usa la richiesta REST sopra.

POST viene rifiutata prima di raggiungere la cartella. Verifica che la chiave bearer abbia ambito full e accesso alla superficie API. Le operazioni non GET richiedono di norma l’ambito completo, salvo una deroga ristretta esplicita della route, assente per la POST dei preferiti.

GET restituisce “Not a member” o un rifiuto di accesso a File. Controlla ID dello spazio di lavoro, vincolo della chiave, appartenenza attiva, assenza di restrizioni a cartelle e permesso del ruolo per la pagina File. Queste regole GET non invalidano retroattivamente un riferimento creato con POST riuscita.

La richiesta segnala un duplicato. Non riprovare. Leggi invece la riga dei preferiti esistente; il server consente un solo riferimento per utente e cartella.

Guide correlate

• Organizzare i file
• Cercare file