Convertir Excel en JSON à l’aide de l’API Aspose.Cells Cloud – Guide rapide

API REST

Cette API REST convertit un fichier de feuille de calcul en fichier au format JSON.

POST https://api.aspose.cloud/v3.0/cells/convert/json

Sécurité et authentification

Les API Aspose.Cells Cloud sont sécurisées et exigent une authentification basée sur un jeton JWT.

Requête

Paramètres de requête (query parameters)

Nom du paramètre	Type	Description
`password`	string	Mot de passe nécessaire pour ouvrir le fichier Excel (facultatif).
`storageName`	string	Nom du stockage où le fichier est situé (facultatif).
`checkExcelRestriction`	bool	Applique des restrictions spécifiques à Excel lors de la modification des cellules (facultatif).

Paramètre du corps de la requête

Nom du paramètre	Type	Description
`datafile`	file	Le fichier Excel à télécharger. Doit être envoyé en tant que première partie d’une requête `multipart/form-data`.

Exemple d’appel cURL

curl -X POST "https://api.aspose.cloud/v3.0/cells/convert/json" \
     -H "Authorization: Bearer $ACCESS_TOKEN" \
     -H "accept: application/json" \
     -H "Content-Type: multipart/form-data" \
     -F "File=@myWorkbook.xlsx"

Réponse

Le service renvoie un objet FileInfo. Les champs importants sont décrits ci-dessous :

Champ	Type	Description
`Filename`	string	Nom du fichier JSON généré (par exemple, `myWorkbook.json`).
`FileSize`	integer	Taille du fichier généré, en octets.
`FileContent`	string	Contenu du fichier JSON encodé en Base64. Décodez-le pour obtenir le JSON réel.

Exemple de réponse

{
  "Filename": "myWorkbook.json",
  "FileSize": 8423,
  "FileContent": "eyJmb3JtYXR0ZWRfZGF0YSI6IH ... (chaîne base64) ..."
}

Gestion des erreurs

Si la requête échoue, l’API renvoie un objet d’erreur ayant la structure suivante :

Champ	Type	Description
`Code`	string	Identifiant d’erreur lisible par machine.
`Message`	string	Description lisible par l’homme de l’erreur.

Codes d’état HTTP courants :

400 – Requête incorrecte (par exemple, fichier manquant, paramètres non valides).
401 – Non autorisé (jeton d’accès non valide ou manquant).
500 – Erreur interne du serveur.

Codes d’état HTTP

Code	Signification	Description
200	OK	Filtre appliqué avec succès ; la réponse contient les détails de l’opération.
400	Requête incorrecte	Paramètres manquants ou non valides (par exemple, type de fichier non pris en charge).
401	Non autorisé	Jeton JWT non valide ou manquant.
413	Charge utile trop grande	Le fichier téléchargé dépasse la taille limite.
500	Erreur interne du serveur	Erreur inattendue sur le serveur.

Comment utiliser l’API PostConvertWorkbookToJson avec les SDK

Spécification de l’API PostConvertWorkbookToJson

La Spécification OpenAPI définit une interface de programmation accessible publiquement et permet d’effectuer 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.

Requête

curl -X POST "https://api.aspose.cloud/v3.0/cells/convert/json" \
     -H "Authorization: Bearer $ACCESS_TOKEN" \
     -H "accept: application/json" \
     -H "Content-Type: multipart/form-data" \
     -F "File=@myWorkbook.xlsx"

Réponse

{
  "Filename": "myWorkbook.json",
  "FileSize": 8423,
  "FileContent": "eyJmb3JtYXR0ZWRfZGF0YSI6IH... (chaîne base64)"
}

Utiliser les SDK Aspose.Cells Cloud

Utiliser un SDK constitue la meilleure façon d’accélérer le développement. Un SDK gère les détails de bas niveau afin que vous puissiez vous concentrer sur les tâches de votre projet. 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 effectuer des appels aux services web Aspose.Cells à l’aide de divers SDK :

Autres API implémentant une fonctionnalité similaire

POST /cells/{name}/saveAs – Enregistre un fichier Excel en tant que fichier HTML avec des paramètres supplémentaires et stocke le résultat dans le stockage spécifié.
PUT /cells/convert – Convertit un fichier Excel en fichier HTML avec des paramètres supplémentaires et renvoie le résultat dans la réponse.
GET /cells/{name} – Récupère un fichier Excel ; peut être utilisé avec des paramètres de requête pour obtenir le fichier au format HTML.

Convertir Excel en HTML