Lägg till en digital signatur i en Excel-arbetsbok – Aspose.Cells Cloud API

Förutsättningar:
Innan du anropar denna slutpunkt ska du säkerställa att du har:

En giltig JWT-åtkomsttoken som du har fått via Aspose Cloud-autentisering.
Målarbetsboken redan uppladdad till ditt Aspose Cloud-lager.
En digital signaturfil i formatet .pfx eller .p12 samt dess lösenord.

Detta REST API lägger till en digital signatur i en Excel-arbetsbok.

PostDigitalSignature API

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

Säkerhet och autentisering

Aspose.Cells Cloud-API:en är säkra och kräver JWT-tokenbaserad autentisering.

Begäranparametrar

Parameter Namn	Typ	Plats	Beskrivning
name	string	`<code>path</code>`	Namnet på arbetsboken.
digitalsignaturefile	string	`<code>query</code>`	Sökvägen till den digitala signaturfilen (`.pfx` eller `.p12`).
password	string	`<code>query</code>`	Lösenord för arbetsboken, om den är skyddad.
folder	string	`<code>query</code>`	Mapp där arbetsboken lagras.
storageName	string	`<code>query</code>`	Namn på det lagringstjänst som ska användas.

Obs: Om filnamnet innehåller specialtecken ska du URL-koda det innan du lägger till det i frågesträngen.

Felhantering

HTTP-status	Betydelse
200	Signatur tillagd utan problem.
400	Felaktig begäran – saknade eller ogiltiga parametrar.
401	Auktoriseringsfel – ogiltig eller utgången OAuth-token.
403	Åtkomst nekad – otillräckliga rättigheter eller nekad åtkomst.
500	Internt serverfel – oväntat fel.

HTTP-status och felaktiga svarsmeddelanden

HTTP-status	Kod	Beskrivning
400	BadRequest	Saknade eller ogiltiga parametrar.
401	Unauthorized	Ogiltig eller saknad åtkomsttoken.
404	NotFound	Den angivna arbetsboken hittades inte i den givna mappen/lagret.
500	InternalServerError	Oväntat serverfel.

Hur du använder PostDigitalSignature API med SDK:er

PostDigitalSignature API-specifikation

OpenAPI-specifikationen definierar ett offentligt tillgängligt programmeringsgränssnitt och låter dig utföra REST-interaktioner direkt från en webbläsare.

Du kan använda kommandoradsverktyget cURL för att anropa Aspose.Cells-webbtjänster. Exemplet nedan visar en begäran till API:et:

Begäran

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

Svar

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

Svarsschema
API:et returnerar ett JSON-objekt med följande fält:

Fält	Typ	Beskrivning
`Code`	int	HTTP-liknande statuskod som indikerar resultatet.
`Status`	string	Kort text som beskriver utfallet (t.ex. `OK`).
`SignatureId`	string	Identifierare för den tillagda digitala signatur (valfritt).
`Message`	string	Ytterligare information eller feldetaljer (valfritt).

Använd Aspose.Cells Cloud SDK:er

Att använda en SDK förenklar integrationen och minskar mängden kod som behöver skrivas. Kontrollera GitHub-förrådet för en komplett lista över Aspose.Cells Cloud SDK:er.

Följande kodexempel visar hur du anropar Aspose.Cells-webbtjänster med olika SDK:er:

Säkerhetskopiera en Excel-arbetsbok med Aspose.Cells Cloud API Säkerhetskopiera Excel-filer