Ajouter une ligne vide à une feuille de calcul Excel à l’aide de l’API Aspose.Cells Cloud

Cette API REST ajoute une nouvelle ligne à une feuille de calcul Excel. Elle insère une ligne vide à l’index zéro-based spécifié.

Conditions préalables :

Un jeton d’accès Aspose Cloud valide (Bearer JWT) doit être inclus dans l’en-tête Authorization.
Le classeur cible doit être chargé dans votre stockage Aspose Cloud, et les paramètres folder et storageName doivent pointer vers son emplacement.

Notes :

L’index rowIndex est zéro-based ; l’insertion à l’index 0 ajoute une ligne en haut de la feuille de calcul.
Les feuilles de calcul Excel comportent un maximum de 1 048 576 lignes ; tenter d’insérer au-delà de cette limite entraînera une erreur.

API PutInsertWorksheetRow

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows/{rowIndex}

Sécurité et authentification

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

Paramètres de la requête

Nom du paramètre	Type	Emplacement	Description
name	string	path	Le nom du fichier du classeur.
sheetName	string	path	Le nom de la feuille de calcul.
rowIndex	integer	path	L’index zéro-based à partir duquel la nouvelle ligne sera insérée.
folder	string	query	Le chemin du dossier dans le stockage contenant le classeur.
storageName	string	query	Le nom du stockage Aspose Cloud à utiliser.

La Spécification OpenAPI définit une interface de programmation publiquement accessible et vous permet d’effectuer 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 suivant montre comment effectuer des appels à l’API Cloud à l’aide de cURL.

Requête

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/10" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jeton jwt>"

Remarque : Tous les points de terminaison Aspose.Cells Cloud exigent HTTPS. Utilisez le schéma sécurisé https:// pour les appels en production.

Réponse

{
  "Code": 200,
  "Status": "OK"
}

Codes de statut 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 invalide ou manquant.
413	Charge utile trop grande	Le fichier téléchargé dépasse la limite de taille.
500	Erreur interne du serveur	Erreur serveur inattendue.

Exemple de réponse d’erreur (par exemple, si l’index de ligne dépasse la limite de la feuille de calcul) :

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "Index de ligne hors limites. Nombre maximal de lignes autorisé : 1048576."
}

Famille de SDK Cloud

Utiliser un SDK est le meilleur moyen d’accélérer le développement. Un SDK masque les détails de bas niveau, vous permettant de 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 appeler les services web Aspose.Cells à l’aide de divers SDK :