Hämta alla former på ett Excel-arbetsblad

Detta REST API möjliggör hämtning av alla former på ett Excel-arbetsblad.

Säkerhet och autentisering

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

REST API

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

Begärandeparametrar

Parameternamn	Typ	Plats	Beskrivning
name	string	path	Namnet på Excel-filen.
sheetName	string	path	Namnet på arbetsbladet.
folder	string	query	Mappen som innehåller dokumentet.
storageName	string	query	Namnet på lagringstjänsten som ska användas.
include	string	query	Ställ in på `details` för att returnera fullständiga formegenskaper; annars returneras endast `link`-objekten.

Valfritt: folder, storageName och include kan utelämnas om filen finns i rotlagringen.

Du kan använda kommandoradsverktyget cURL för att komma åt Aspose.Cells webbtjänster. Exemplet nedan visar en begäran som inkluderar de valfria frågeparametrarna.

Begäran

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/shapes?folder=Samples&storageName=MyStorage" \
-X GET \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

Svar

{
  "Shapes": {
    "ShapeList": [
      {
        "link": {
          "Href": "/0",
          "Rel": "self",
          "Type": null,
          "Title": null
        }
      },
      {
        "link": {
          "Href": "/1",
          "Rel": "self",
          "Type": null,
          "Title": null
        }
      },
      {
        "link": {
          "Href": "/2",
          "Rel": "self",
          "Type": null,
          "Title": null
        }
      },
      {
        "link": {
          "Href": "/3",
          "Rel": "self",
          "Type": null,
          "Title": null
        }
      }
    ],
    "link": {
      "Href": "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/shapes",
      "Rel": "self",
      "Type": null,
      "Title": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

Svarsfält

Shapes-objektet innehåller en lista med Shape-objekt. Varje form innehåller följande egenskaper (om flaggan include=details används; annars returneras endast link-objektet).

Egenskap	Typ	Beskrivning
Name	string	Namnet som tilldelats formen (t.ex. “Diagram 1”).
Type	string	Formens typ (t.ex. `Chart`, `Picture`, `TextBox`).
Top	number	Avståndet i punkter från övre kanten av arbetsbladet till formen.
Left	number	Avståndet i punkter från vänstra kanten av arbetsbladet till formen.
Width	number	Formens bredd i punkter.
Height	number	Formens höjd i punkter.
Link	object	Hyperlänksinformation (`Href`, `Rel`, `Type`, `Title`).

Felhantering

HTTP-status	Beskrivning	Exempel på felkropp
400	Felaktig begäran – felaktiga parametrar.	`{ "Code": 400, "Message": "Ogiltigt parametervärde." }`
401	Obehörig – saknad eller ogiltig token.	`{ "Code": 401, "Message": "Tillgångstoken saknas eller är ogiltig." }`
404	Hittades inte – arbetsbok eller arbetsblad finns inte.	`{ "Code": 404, "Message": "Fil eller arbetsblad hittades inte." }`
500	Internt serverfel – oväntat tillstånd.	`{ "Code": 500, "Message": "Ett oväntat fel inträffade." }`

En lyckad begäran returnerar HTTP 200 med ett Shapes-objekt som innehåller formlistan, som illustreras i ovanstående svarsexempel.

API:et tillämpar en gräns på 150 begäranden per minut per JWT-token. Överskridning av denna gräns returnerar HTTP 429 med en Retry-After-header som anger när en ny försök ska göras.

Moln-SDK-familj

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

Följande kodexempel visar hur man gör anrop till Aspose.Cells webbtjänster med hjälp av olika SDK:er:

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