Hur man konverterar ett kalkylark till CSV med Aspose.Cells Cloud API
ConvertSpreadsheetToCsv-ändpunkten läser in ett kalkylark som laddats upp från en lokal enhet, utför konverteringen helt på Aspose.Cells Cloud-servrar och returnerar den resulterande CSV-filen som en binär ström. Denna molnbasera operation eliminerar behovet av att ladda upp källfilen till molnlagring, minskar lagringskostnader och förenklar arbetsflödet för utvecklare som behöver snabb konvertering från kalkylark till CSV. Stödda format beror på de underliggande biblioteken, och korrekt behörighet krävs för att läsa källfilen. Fel som saknade filer, ogiltiga förfrågningar eller konverteringsfel returneras med standard HTTP-statuskoder.
Konvertera kalkylark till CSV API
PUT https://api.aspose.cloud/v4.0/cells/convert/spreadsheet/csv
Säkerhet och autentisering
Aspose.Cells Cloud API:er är säkra och kräver JWT-tokenbaserad autentisering.
Förfrågningsparametrar:
| Parameter Name | Typ | Plats | Krävs | Beskrivning |
|---|---|---|---|---|
| Spreadsheet | Fil | FormData | Krävs | Kalkylarksfilen som ska konverteras. Godkänner vanliga format som .xls, .xlsx, .xlsm. Måste anges som multipart/form‑data. Exempel: myWorkbook.xlsx. |
| outPath | Sträng | Fråga | Valfritt | Målmappens sökväg där den konverterade CSV-filen ska sparas. Om utelämnas returneras CSV direkt i svarskroppen. Exempel: /output/reports/. |
| outStorageName | Sträng | Fråga | Valfritt | Namn på molnlagringstjänsten där utdatafilen ska sparas. Om inte angiven används standardlagringen som konfigurerats för Aspose.Cells-kontot. |
| fontsLocation | Sträng | Fråga | Valfritt | Sökväg till en mapp med anpassade typsnitt som krävs av kalkylarket. möjliggör korrekt visning av celler som använder icke-standardtypsnitt. |
| region | Sträng | Fråga | Valfritt | Kalkylarkets regionspråkinställning (t.ex. sv-SE, en-US, fr-FR). Påverkar nummerformatering, datumtolkning och språkspecifika beteenden. |
| password | Sträng | Fråga | Valfritt | Lösenord för att öppna lösenordsskyddade kalkylark. Om filen är krypterad och lösenordet saknas eller är felaktigt returneras ett 400/401-fel. |
Svar
Vid lyckad förfrågan returnerar API:et HTTP 200 (eller 202 för asynkron bearbetning) med headern Content-Type: application/octet-stream. Svarskroppen innehåller den genererade CSV-filen som en binär ström.
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
HTTP-statuskoder
| Kod | Betydelse | Beskrivning |
|---|---|---|
| 200 | OK | Filtrering lyckades; svaret innehåller åtgärdens detaljer. |
| 400 | Ogiltig förfrågan | 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. |
Var bör du använda API:et för att konvertera kalkylark till CSV?
- Dataexport för rapporteringssystem – Generera CSV-extrakt från Excel-baserade rapporter för att mata in data i BI-verktyg eller datalagrum utan manuell filhantering.
- Automatiserad batchbearbetning – Konvertera stora mängder lokalt lagrade kalkylark till CSV i ett serverseit jobb, och strömma sedan resultaten direkt till efterföljande tjänster.
- Webbapplikationer med filuppladdning – Låt slutanvändare ladda upp en Excel-fil och omedelbart få en CSV-version för vidare analys eller import till andra plattformar.
- Integration med äldre system – Översätt äldre kalkylarkformat till CSV för system som endast accepterar textbaserade filer med avgränsare.
Varför använda API:et för att konvertera kalkylark till CSV?
- Arkitektur utan uppladdning till molnlagring – Behöver inte lagra källfilen i molnlagring; konverteringen sker direkt från den uppladdade strömmen, vilket sparar tid och lagringskostnader.
- Högpresterande molnbearbetning – Använder Aspose.Cells optimerade konverteringsmotor på skalbara moln servrar och levererar snabb CSV-utdata även för stora arbetsböcker.
- Enkel integration – Enkel PUT-förfrågan med valfria frågeparametrar; returnerar CSV som en färdig nedladdningsbar binär ström, vilket eliminerar efterbehandlingsskeden.
- Full funktionsunderstöd – Hanterar lösenordsskyddade filer, anpassade typsnitt och språkspecifika inställningar för att säkerställa korrekt konvertering av komplexa kalkylark.
Hur man använder API:et för att konvertera kalkylark till CSV med SDK:er
API-specifikation för att konvertera kalkylark till CSV
API-specifikation för att konvertera kalkylark till CSV tillhandahåller ett offentligt tillgängligt programmeringsgränssnitt för att 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 man gör anrop till Cloud API med cURL.
Använd Aspose.Cells Cloud SDK:er
Att använda SDK är det snabbaste sättet att utveckla, eftersom den döljer de detaljerade tekniska detaljerna och låter dig arbeta med kalkylark med koncist kod. Se GitHub-lagringsplatsen för en komplett lista över Aspose.Cells Cloud SDK:er. Följande kodexempel visar hur man interagerar med Aspose.Cells webbtjänster med olika SDK:er: