Obtener comentario de hoja de cálculo – Documentación de la API de Aspose.Cells Cloud
Esta REST API recupera un comentario de hoja de cálculo por nombre de celda utilizando Aspose.Cells Cloud.
Requisitos previos: Para llamar a esta operación, debe incluir un token de acceso JWT válido en el encabezado Authorization (Bearer <jwt token>). Los tokens se pueden obtener mediante el flujo de autenticación de Aspose.Cells Cloud descrito en la guía de autenticación.
API GetWorksheetComment
GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/comments/{cellName}
Seguridad y autenticación
Las API de Aspose.Cells Cloud son seguras y requieren autenticación basada en token JWT.
Parámetros de solicitud
| Nombre del parámetro | Tipo | Ubicación (ruta URL / cadena de consulta) | Descripción |
|---|---|---|---|
| name | string | Ruta URL | Nombre del archivo de Excel. |
| sheetName | string | Ruta URL | Nombre de la hoja de cálculo que contiene el comentario. |
| cellName | string | Ruta URL | Dirección de la celda (por ejemplo, A1) cuyo comentario se está recuperando. |
| folder | string | Cadena de consulta | Ruta de la carpeta donde se almacena el documento. |
| storageName | string | Cadena de consulta | Nombre del servicio de almacenamiento. |
La Especificación OpenAPI define una interfaz de programación accesible públicamente y le permite realizar interacciones REST directamente desde un navegador web.
Puede utilizar la herramienta de línea de comandos cURL para acceder fácilmente a los servicios web de Aspose.Cells. El siguiente ejemplo muestra cómo realizar una llamada a la API en la nube mediante cURL.
Respuesta: La API devuelve un objeto JSON que contiene un objeto Comment con los siguientes campos:
| Campo | Tipo | Descripción |
|---|---|---|
CellName |
string | Dirección de la celda (por ejemplo, A1). |
Author |
string | Nombre del autor del comentario. |
HtmlNote |
string | Contenido del comentario en formato HTML (si existe). |
Note |
string | Versión en texto plano del comentario. |
AutoSize |
boolean | Indica si el cuadro del comentario se redimensiona automáticamente. |
IsVisible |
boolean | Determina si el comentario es visible. |
Width |
integer | Ancho del cuadro del comentario (en caracteres). |
Height |
integer | Alto del cuadro del comentario (en caracteres). |
TextHorizontalAlignment |
string | Alineación horizontal del texto (por ejemplo, Bottom). |
TextOrientationType |
string | Orientación del texto (por ejemplo, TopToBottom). |
TextVerticalAlignment |
string | Alineación vertical del texto (por ejemplo, Bottom). |
Errores comunes
- 401 No autorizado – Verifique que el token JWT sea válido, no haya expirado y esté correctamente colocado en el encabezado
Authorization. - 404 No encontrado – Asegúrese de que el nombre del archivo, el nombre de la hoja de cálculo y la dirección de la celda sean correctos y que el archivo exista en la carpeta/almacenamiento especificados.
- 500 Error interno del servidor – Compruebe que la carga útil de la solicitud no contenga datos mal formados y confirme que el servicio esté operativo.
Códigos de estado HTTP
| Código | Significado | Descripción |
|---|---|---|
| 200 | Correcto | Filtro aplicado correctamente; la respuesta contiene los detalles de la operación. |
| 400 | Solicitud incorrecta | Parámetros faltantes o inválidos (por ejemplo, tipo de archivo no admitido). |
| 401 | No autorizado | Token JWT inválido o ausente. |
| 413 | Carga útil demasiado grande | El archivo subido excede el límite de tamaño. |
| 500 | Error interno del servidor | Error inesperado en el servidor. |
Familia de SDK en la nube
Utilizar un SDK es la mejor forma de acelerar el desarrollo. Un SDK maneja los detalles de bajo nivel y le permite centrarse en las tareas de su proyecto. Consulte el repositorio de GitHub para ver una lista completa de los SDK de Aspose.Cells Cloud.
Los siguientes ejemplos de código demuestran cómo realizar llamadas a los servicios web de Aspose.Cells mediante diversos SDK: