Comment convertir une feuille de calcul locale en JSON à l’aide de l’API Aspose.Cells Cloud
L’endpoint ConvertSpreadsheetToJson convertit une feuille de calcul stockée sur un disque local en fichier JSON entièrement côté serveur Aspose.Cells Cloud. En envoyant la feuille de calcul sous la forme multipart/form-data, le service renvoie un flux JSON prêt à être téléchargé ou traité ultérieurement. Cette conversion native cloud élimine la nécessité de télécharger d’abord le fichier vers le stockage, réduit les coûts de stockage et simplifie le flux de travail des applications exigeant des données de feuille de calcul au format JSON pour l’analyse, les rapports ou l’échange de données.
Prérequis : Vous devez disposer d’un compte Aspose Cloud, d’un jeton d’accès JWT valide, ainsi que du SDK ou de la clé API Aspose.Cells Cloud configurés.
Contexte : La conversion de feuilles de calcul en JSON est une étape fréquente lors de l’intégration des données Excel avec des services web, des bases de données NoSQL ou des applications JavaScript côté client. L’API Convert Spreadsheet to JSON propose une conversion rapide côté serveur, sans avoir à conserver le fichier original.
API Convert Spreadsheet to JSON
PUT https://api.aspose.cloud/v4.0/cells/convert/spreadsheet/json
Sécurité et authentification
Les API Aspose.Cells Cloud sont sécurisées et nécessitent une authentification basée sur un jeton JWT.
Paramètres de la requête
| Nom du paramètre | Type | Emplacement | Obligatoire/Optionnel | Description |
|---|---|---|---|---|
| Spreadsheet | Fichier (multipart/form-data) | FormData | Obligatoire | Le fichier source de la feuille de calcul (par ex. .xls, .xlsx, .xlsm). Exemple : curl -F "Spreadsheet=@monFichier.xlsx" |
| outPath | String | Query | Optionnel | Chemin du dossier cible dans le stockage cloud où le fichier JSON converti sera enregistré. Si omis, le JSON est renvoyé directement dans le flux de réponse. Exemple : outPath=/output/. |
| outStorageName | String | Query | Optionnel | Nom du stockage cloud (par ex. Amazon S3, Azure Blob) dans lequel le fichier de sortie doit être écrit. Obligatoire uniquement si outPath est utilisé avec un stockage non par défaut. |
| fontsLocation | String | Query | Optionnel | Chemin vers un dossier personnalisé contenant des polices sur le serveur. À utiliser lorsque la feuille de calcul fait référence à des polices non disponibles dans la bibliothèque par défaut. |
| region | String | Query | Optionnel | Paramètre de région/langue de la feuille de calcul (par ex. fr-FR, en-US). Affecte le formatage des nombres, des dates et des devises durant la conversion. |
| password | String | Query | Optionnel | Mot de passe pour ouvrir une feuille de calcul protégée par mot de passe. À omettre pour les fichiers non protégés. |
Réponse
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
Codes de statut HTTP
| Code | Signification | Description |
|---|---|---|
| 200 | OK | Le filtre a été appliqué avec succès ; la réponse contient les détails de l’opération. |
| 400 | Mauvaise requête | Paramètres manquants ou non valides (par ex. type de fichier non pris en charge). |
| 401 | Non autorisé | Jeton JWT invalide ou manquant. |
| 413 | Charge utile trop volumineuse | Le fichier téléchargé dépasse la taille limite autorisée. |
| 500 | Erreur interne du serveur | Erreur serveur inattendue. |
Où utiliser l’API Convert Spreadsheet to JSON ?
- Pipelines de migration de données – Convertir des rapports Excel hérités en JSON afin de les ingérer dans des bases de données NoSQL modernes ou des lacs de données.
- Applications mobiles ou web – Transformer rapidement les feuilles de calcul uploadées par les utilisateurs en JSON pour un rendu côté client, sans stocker le fichier original dans le cloud.
- Rapport automatisé – Générer des charges utiles JSON pour des services d’analyse en aval (par ex. Power BI, Tableau) directement à partir d’entrées de feuilles de calcul.
- Fonctions sans serveur – Utiliser l’API dans AWS Lambda ou Azure Functions pour effectuer des conversions à la volée sans gérer de stockage temporaire.
Pourquoi utiliser l’API Convert Spreadsheet to JSON ?
- Conversion native cloud : élimine le besoin de télécharger de gros fichiers vers le stockage avant traitement, réduisant ainsi la latence et les coûts de stockage.
- Flux de travail en une seule requête : téléchargez la feuille de calcul et recevez le JSON dans le même appel HTTP, simplifiant la logique d’intégration.
- Prend en charge les feuilles de calcul protégées par mot de passe et celles spécifiques à une région, garantissant une représentation précise des données selon les localisations.
- Évolutif sur l’infrastructure Aspose : gère de gros classeurs et des formules complexes sans impacter les ressources de votre propre serveur.
Comment utiliser l’API Convert Spreadsheet to JSON avec les SDK
Spécification de l’API Convert Spreadsheet to JSON
La spécification de l’API Convert Spreadsheet to JSON fournit une interface de programmation publiquement accessible permettant d’exécuter directement des interactions REST depuis un navigateur web.
Vous pouvez utiliser l’outil en ligne de commande cURL pour accéder facilement aux services web Aspose.Cells. L’exemple ci-dessous montre comment effectuer des appels vers l’API Cloud avec cURL.
Utiliser les SDK Aspose.Cells Cloud
L’utilisation d’un SDK constitue la méthode la plus rapide pour développer, car elle masque les détails de bas niveau et permet de convertir une feuille de calcul en JSON en quelques lignes de code.
Consultez le dépôt GitHub pour obtenir la liste complète des SDK Aspose.Cells Cloud.
Les exemples de code suivants montrent comment interagir avec les services web Aspose.Cells à l’aide de divers SDK :