Proteggi file Excel

Questa API REST protegge i file Excel.

API REST

POST http://api.aspose.cloud/v3.0/cells/protect

Sicurezza e autenticazione

Le API Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
file	file	formData (body)	File da caricare
password	string	stringa di query (`password`)	Password utilizzata per proteggere la cartella di lavoro

Risposta

{
  "Status": "OK",
  "Code": 200,
  "Files": [
    {
      "Filename": "nome file protetto: smaple1.xlsx",
      "FileSize": dimensione,
      "FileContent": "-----Stringa Base64 di sample1-----"
    },
    {
      "Filename": "nome file protetto: sample2.xlsx",
      "FileSize": dimensione,
      "FileContent": "-----Stringa Base64 di sample2-----"
    }
  ]
}

Codici di stato HTTP

Codice	Significato	Descrizione
200	OK	Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione.
400	Richiesta non valida	Parametri mancanti o non validi (ad esempio, tipo di file non supportato).
401	Non autorizzato	Token JWT non valido o mancante.
413	Payload troppo grande	Il file caricato supera il limite di dimensione.
500	Errore interno del server	Errore imprevisto sul server.

Come utilizzare l’API PostProtect con gli SDK

Specifica dell’API PostProtect

La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile e consente di effettuare interazioni REST direttamente da un browser web.

Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web Aspose.Cells. L’esempio seguente mostra come chiamare l’API Cloud con cURL.

Richiesta

curl -v "http://api.aspose.cloud/v3.0/cells/protect?password=MySecretPwd" \
  -X POST \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <token jwt>" \
  -F 'file1=@sample1.xlsx' \
  -F 'file2=@sample2.xlsx'

Risposta

{
  "Files": [
    {
      "Filename": "sample1.xlsx",
      "FileSize": 274022,
      "FileContent": "-----Stringa Base64 di sample1-----"
    },
    {
      "Filename": "sample2.xlsx",
      "FileSize": 274022,
      "FileContent": "-----Stringa Base64 di sample2-----"
    }
  ]
}

Gestione degli errori

– L’API può restituire i seguenti codici di stato:

Codice HTTP	Significato	Esempio di payload JSON di errore
400	Richiesta non valida (ad esempio, file mancante)	`{"Code":400,"Message":"Il file è obbligatorio."}`
401	Non autorizzato (token non valido o mancante)	`{"Code":401,"Message":"Token di accesso non valido."}`
403	Accesso negato (permessi insufficienti)	`{"Code":403,"Message":"Accesso negato."}`
500	Errore interno del server	`{"Code":500,"Message":"Errore imprevisto del server."}`

Utilizzare gli SDK di Aspose.Cells Cloud

L’utilizzo di un SDK è il modo più rapido per sviluppare. Un SDK gestisce i dettagli di basso livello, consentendoti di concentrarti sulle attività del tuo progetto. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come chiamare i servizi web Aspose.Cells utilizzando vari SDK:

Decrittografa un Workbook di Excel