Comment convertir une feuille de calcul de classeur en JSON à l'aide de l'API Aspose.Cells Cloud
Le point de terminaison ConvertWorksheetToJson lit un fichier de classeur à partir du système de fichiers local, extrait la feuille de calcul spécifiée, et renvoie son contenu sous forme de fichier JSON. La conversion est entièrement effectuée sur les serveurs Aspose.Cells Cloud, ce qui élimine la nécessité de télécharger ou stocker préalablement les fichiers. Cette solution prend en charge les classeurs protégés par mot de passe, les emplacements personnalisés de polices de caractères et les paramètres régionaux, offrant ainsi une solution rapide et native cloud pour exporter des données de feuille de calcul au format JSON, en vue d’un traitement ultérieur.
API Convertir une feuille de calcul en JSON
API Web
PUT https://api.aspose.cloud/v4.0/cells/convert/worksheet/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 / Facultatif | Description |
|---|---|---|---|---|
| Spreadsheet | file | FormData | Obligatoire | Le classeur Excel à traiter. Doit être au format pris en charge (xls, xlsx, csv, etc.). Envoyé en tant que multipart/form-data. Exemple : Spreadsheet=@C:\Docs\Exemple.xlsx. |
| worksheet | string | Query | Obligatoire | Nom exact de la feuille de calcul à convertir (sensible à la casse). Si omis ou introuvable, l’API renvoie une erreur. Exemple : worksheet=Feuil1. |
| outPath | string | Query | Facultatif | Dossier de destination sur le stockage cloud configuré, où le fichier JSON généré sera enregistré. Si non fourni, le JSON est renvoyé directement dans le flux de réponse. Exemple : outPath=/converted/. |
| outStorageName | string | Query | Facultatif | Nom du stockage cible (par exemple, « MyStorage ») contenant le chemin outPath. Utilise le stockage par défaut si omis. |
| fontsLocation | string | Query | Facultatif | Dossier côté serveur contenant les polices personnalisées nécessaires à un rendu précis du texte dans la feuille de calcul. Exemple : fontsLocation=/fonts/custom/. |
| region | string | Query | Facultatif | Identifiant culturel/régional qui influence le formatage des nombres, des dates et des devises dans le JSON généré (par exemple, fr-FR, en-US). |
| password | string | Query | Facultatif | Mot de passe permettant d’ouvrir un classeur chiffré. Si le classeur n’est pas protégé par mot de passe, omettez ce paramètre. |
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. |
| 400 | Demande incorrecte | Paramètres manquants ou invalides (par exemple, type de fichier non pris en charge). |
| 401 | Non autorisé | Jeton JWT invalide ou manquant. |
| 413 | Payload trop volumineux | Le fichier téléchargé dépasse la limite de taille. |
| 500 | Erreur interne du serveur | Erreur serveur inattendue. |
À quelles situations faut-il utiliser l’API Convertir une feuille de calcul en JSON ?
- Tableaux de bord web – Exporter les données de la feuille de calcul au format JSON pour les bibliothèques de graphiques côté client (par exemple, Chart.js, D3.js).
- Migration de données – Transférer des données Excel héritées vers des bases de données NoSQL ou des services REST consommant du JSON.
- Applications mobiles ou hors ligne – Convertir le contenu de la feuille de calcul en JSON côté serveur, puis synchroniser la charge utile légère sur les appareils mobiles.
- Pipelines de production de rapports – Alimenter directement les moteurs d’analyse avec les données de la feuille de calcul au format JSON, sans étape intermédiaire en CSV.
Pourquoi utiliser l’API Convertir une feuille de calcul en JSON ?
- Flux de travail sans téléchargement préalable – Traiter des fichiers locaux dans le cloud sans les télécharger d’abord vers le stockage, économisant ainsi bande passante et coûts de stockage.
- Conversion complète – Prend en charge les classeurs protégés par mot de passe, les polices personnalisées et le formatage régional pour une représentation précise des données.
- Exécution rapide et évolutif – Exploite le moteur haute performance d’Aspose.Cells sur une infrastructure cloud, gérant efficacement les grandes feuilles de calcul.
- Intégration simplifiée – Un seul appel PUT renvoie un fichier JSON prêt à l’emploi ou l’enregistre directement, réduisant la complexité du code dans les applications clientes.
Comment utiliser l’API Convertir une feuille de calcul en JSON avec les SDK
Spécification de l’API Convertir une feuille de calcul en JSON
La Spécification de l’API Convertir une feuille de calcul en JSON fournit une interface de programmation publiquement accessible pour exécuter des interactions REST directement 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 suivant montre comment effectuer des appels à l’API cloud avec cURL.
Utiliser les SDK Aspose.Cells Cloud
L’utilisation des SDK est la méthode la plus rapide pour développer, car elle masque les détails de bas niveau et vous permet de travailler avec des classeurs à l’aide d’un code concis. Veuillez consulter 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 :