Hinzufügen einer digitalen Signatur zu einer Excel-Arbeitsmappe|Dokument

Voraussetzungen:
Bevor Sie diesen Endpunkt aufrufen, stellen Sie sicher, dass Folgendes vorliegt:

Ein gültiges JWT-Zugriffstoken, das über die Aspose Cloud-Authentifizierung erhalten wurde.
Die Ziel-Arbeitsmappe ist in Ihrem Aspose Cloud-Speicher hochgeladen.
Eine digitale Signaturdatei im Format .pfx oder .p12 sowie deren Passwort.

Diese REST-API fügt einer Excel-Arbeitsmappe eine digitale Signatur hinzu.

PostDigitalSignature API

POST https://api.aspose.cloud/v4.0/cells/{name}/digitalsignature

Sicherheit und Authentifizierung

Die Aspose.Cells Cloud-APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.

Anforderungsparameter

Parametername	Typ	Position	Beschreibung
name	string	`<code>path</code>`	Der Name der Arbeitsmappe.
digitalsignaturefile	string	`<code>query</code>`	Pfad zur digitalen Signaturdatei (`.pfx` oder `.p12`).
password	string	`<code>query</code>`	Passwort für die Arbeitsmappe, sofern geschützt.
folder	string	`<code>query</code>`	Ordner, in dem die Arbeitsmappe gespeichert ist.
storageName	string	`<code>query</code>`	Name des zu verwendenden Speicherdienstes.

Hinweis: Falls der Dateiname Sonderzeichen enthält, müssen Sie ihn vor dem Hinzufügen zur Abfragezeichenfolge URL-kodieren.

Fehlerbehandlung

HTTP-Status	Bedeutung
200	Signatur erfolgreich angewendet.
400	Ungültige Anforderung – fehlende oder ungültige Parameter.
401	Nicht autorisiert – ungültiges oder abgelaufenes OAuth-Token.
403	Verboten – unzureichende Berechtigungen oder Zugriff verweigert.
500	Interner Serverfehler – unerwarteter Fehler.

HTTP-Status-Fehlerantworten

HTTP-Status	Code	Beschreibung
400	BadRequest	Fehlende oder ungültige Parameter.
401	Unauthorized	Ungültiges oder fehlendes Zugriffstoken.
404	NotFound	Angegebene Arbeitsmappe im angegebenen Ordner/Speicher nicht gefunden.
500	InternalServerError	Unerwarteter Serverfehler.

Verwendung der PostDigitalSignature API mit SDKs

PostDigitalSignature API-Spezifikation

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht REST-Interaktionen direkt über einen Webbrowser.

Sie können das cURL-Befehlszeilentool verwenden, um Aspose.Cells-Webdienste aufzurufen. Das folgende Beispiel zeigt eine Anfrage an die API:

Anforderung

curl -v "https://api.aspose.cloud/v4.0/cells/{name}/digitalsignature?digitalsignaturefile=signature.pfx&password=IhrPasswort" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Antwort

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

Antwort-Schema
Die API gibt ein JSON-Objekt mit den folgenden Feldern zurück:

Feld	Typ	Beschreibung
`Code`	int	HTTP-ähnlicher Statuscode, der das Ergebnis angibt.
`Status`	string	Kurzer Text zur Beschreibung des Ergebnisses (z. B. `OK`).
`SignatureId`	string	Bezeichner der angewendeten digitalen Signatur (optional).
`Message`	string	Zusätzliche Informationen oder Fehlerdetails (optional).

Verwendung der Aspose.Cells Cloud SDKs

Die Verwendung eines SDK vereinfacht die Integration und reduziert den Boilerplate-Code. Besuchen Sie das GitHub-Repository, um eine vollständige Liste der Aspose.Cells Cloud SDKs zu erhalten.

Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webdienste mithilfe verschiedener SDKs aufgerufen werden: