Blocca file Excel – Documentazione API Aspose.Cells Cloud

Versione API: v3.0 (corrente)

Questa REST API blocca le cartelle di lavoro Excel.

API PostLock

POST https://api.aspose.cloud/v3.0/cells/lock

Prerequisiti – La richiesta deve essere inviata tramite HTTPS e includere un token Bearer OAuth 2.0 valido nell’header Authorization.

I parametri della richiesta sono

Nome parametro	Tipo	Posizione	Descrizione
file	file	form‑data (corpo multipart)	La cartella di lavoro Excel da caricare e bloccare.
password	string	stringa di query	Password per la cartella di lavoro (opzionale).

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 tramite cURL.

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/lock?password=123456" \
  -X POST \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <access_token>" \
  -F "file=@Sample.xlsx"

Risposta

{
  "Files": [
    {
      "Filename": "Sample.xlsx",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

Puoi scaricare una cartella di lavoro di esempio — Sample.xlsx — per testare la richiesta.

Nota: L’API supporta file di dimensioni massime pari a 100 MB; payload più grandi potrebbero generare una risposta 413 (Payload Troppo Grande).

Dettagli della risposta

Campo	Tipo	Descrizione
Filename	string	Nome della cartella di lavoro bloccata restituita dal servizio.
FileSize	integer	Dimensione del file bloccato in byte.
FileContent	string (Base64)	La cartella di lavoro bloccata codificata come stringa Base64.

Per recuperare la cartella di lavoro bloccata, decodifica il valore FileContent da Base64 e salvala utilizzando il nome Filename fornito nella risposta.

Gestione degli errori

– L’API restituisce i codici di stato HTTP standard (ad esempio, 400 Bad Request, 401 Unauthorized, 500 Internal Server Error) insieme a un oggetto JSON di errore che contiene i campi Code e Message.

Famiglia di SDK Cloud

L’utilizzo di un SDK è il modo migliore per velocizzare lo sviluppo. Un SDK astrae i dettagli a 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 effettuare chiamate ai servizi web Aspose.Cells utilizzando vari SDK: