Protezione in Batch di File Excel

Questa API REST consente la protezione in batch di file Excel idonei.

API REST

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

Sicurezza e autenticazione

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

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
batchProtectRequest	BatchProtectRequest	body	Payload JSON che specifica la cartella di origine, le condizioni di selezione, il tipo di protezione, la password e la cartella di output.

Proprietà di BatchProtectRequest

Nome	Tipo	Descrizione	Note
SourceFolder	string	Cartella contenente i file Excel di origine.	opzionale
MatchCondition	MatchConditionRequest	Criteri utilizzati per selezionare i file da proteggere.	opzionale
ProtectionType	string	Tipo di protezione da applicare (ad es. `All`, `ReadOnly`).	opzionale
Password	string	Password da impostare per i file protetti.	opzionale
OutFolder	string	Cartella di destinazione per i file protetti.	opzionale

Proprietà di MatchConditionRequest

Nome	Tipo	Descrizione	Note
RegexPattern	string	Espressione regolare utilizzata per confrontare i nomi dei file.	opzionale
FullMatchConditions	string[]	Elenco di condizioni esatte per i nomi dei file.	opzionale

Parametro del corpo della richiesta

Nome parametro	Tipo	Descrizione
data	file	Contenuto binario del file del foglio di calcolo da creare.

Risposta

{
    "Name": "ResponseFile",
    "DataType": {
        "Identifier": "File",
        "Reference": "Stream",
        "Name": "file"
    }
}

Codici di stato HTTP

Codice	Significato	Quando viene restituito
200 OK	Foglio di calcolo creato correttamente	Flusso normale
201 Created	Foglio di calcolo creato (risposta alternativa)	Quando l’API restituisce lo stato “created”
400 Bad Request	Parametri non validi	Errore lato client
401 Unauthorized	Token mancante o non valido	Errore di autenticazione
409 Conflict	Il file esiste e `isWriteOver=false`	Conflitto con un file esistente

Come utilizzare l’API PostProtectConvert con gli SDK

Specifica dell’API PostProtectConvert

La Specifica OpenAPI definisce un’interfaccia di programmazione accessibile pubblicamente 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 di Aspose.Cells. L’esempio seguente mostra come effettuare una chiamata all’API Cloud con cURL.

Richiesta

curl -v "http://api.aspose.cloud/v3.0/cells/batch/protect" \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>" \
-D "{\"SourceFolder\":\"CellsTests\",\"OutFolder\":\"Output\",\"MatchCondition\":{\"RegexPattern\":\"(^Book)(.+)(xlsx$)\"},\"Password\":\"123456\",\"ProtectionType\":\"All\"}"

Risposta

{
  "Code": 200,
  "Status": "OK"
}

Utilizzare gli SDK di Aspose.Cells Cloud

L’utilizzo di un SDK è il modo migliore per accelerare lo sviluppo. Un SDK gestisce i dettagli di basso livello e ti consente 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 di Aspose.Cells utilizzando vari SDK: