Lägg till en form i ett Excel-arbetsblad med Aspose.Cells Cloud API

Denna REST API lägger till en form i ett Excel-arbetsblad.
Slutpunkten tillhör API-version v3.0; se till att du använder ett JWT-åtkomsttoken som du får via Aspose Cloud OAuth2-flödet (client-id/client-secret) och inkludera den i Authorization: Bearer <token>-hoften.

Säkerhet och autentisering

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

PutWorksheetShape API

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/shapes

Begäranparametrar

Parametername	Typ	Plats	Beskrivning
name	string	path	Dokumentets namn.
sheetName	string	path	Arbetsbladets namn.
shapeDTO	object	body	JSON-objekt som beskriver formen som ska läggas till (se OpenAPI-specifikationen för fullständigt schema).
drawingType	string	query	Typ av formobjekt (t.ex. `arc`, `line`, `rectangle`).
upperLeftRow	integer	query	Övre vänstra radindex för formen.
upperLeftColumn	integer	query	Övre vänstra kolumnindex för formen.
top	integer	query	Vertikal förskjutning från formens övre kant, i bildpunkter.
left	integer	query	Horisontell förskjutning från formens vänstra kant, i bildpunkter.
width	integer	query	Formens bredd, i bildpunkter.
height	integer	query	Formens höjd, i bildpunkter.
folder	string	query	Mappen som innehåller dokumentet.
storageName	string	query	Namn på lagringsutrymmet.

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 enkelt att komma åt Aspose.Cells-webbtjänster. Följande exempel visar hur du gör ett anrop till moln-API:et med cURL.

Begäran

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/shapes?DrawingType=arc&upperLeftRow=1&upperLeftColumn=1&top=1&left=1&width=100&height=100" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Svar

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

Ett lyckat svar returnerar HTTP-statuskoden, en textuell status och identifieraren för den nyligen skapade formen (ShapeId).

HTTP-statuskoder

Kod	Betydelse	Beskrivning
200	OK	Filter tillämpades framgångsrikt; svaret innehåller åtgärdens detaljer.
400	Felaktig begäran	Saknade eller ogiltiga parametrar (t.ex. filtyp som inte stöds).
401	Oauktoriserad	Ogiltig eller saknad JWT-token.
413	För stor nyttolast	Den uppladdade filen överskrider storleksgränsen.
500	Internt serverfel	Oväntat serverfel.

Typiska felaktiga svar inkluderar:

400 Felaktig begäran – saknade eller ogiltiga parametrar.
401 Oauktoriserad – ogiltig eller saknad JWT-token.
404 Ej hittad – det angivna arbetsbladet eller dokumentet finns inte.

Varje fel returneras som ett JSON-objekt med fälten Code och Message.

Molntjänstfamilj för SDK

Att använda en SDK är det bästa sättet att påskynda utvecklingen. En SDK hanterar detaljer på lågnivå så att du kan fokusera på dina projektuppgifter. Ta en titt på GitHub-förrådet för en fullständig lista över Aspose.Cells Cloud SDK:er.

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

Hämta en form efter index på ett Excel-arbetsark Uppdatera en form i ett Excel-ark