Obtener una forma por índice en una hoja de cálculo de Excel – Documentación de Aspose.Cells Cloud
Esta API REST recupera una forma (incluidos sus datos de imagen o metadatos) desde una hoja de cálculo de Excel.
API GetWorksheetShape
GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/shapes/{shapeindex}
Prerrequisitos
- Un token de acceso válido de Aspose Cloud (Bearer JWT).
- El libro de cálculo debe estar almacenado en su almacenamiento de Aspose Cloud o en una carpeta especificada.
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 | Descripción |
|---|---|---|---|
| name | string | path | Nombre del documento de Excel. |
| sheetName | string | path | Nombre de la hoja de cálculo que contiene la forma. |
| shapeindex | integer | path | Índice de base cero de la forma dentro de la hoja. |
| folder | string | query | Ruta de la carpeta donde se almacena el documento. |
| storageName | string | query | Nombre del servicio de almacenamiento. |
Nota: shapeindex es de base cero; la primera forma tiene índice 0. Asegúrese de que el libro esté almacenado en la folder y storageName especificadas si no utiliza el almacenamiento predeterminado.
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 con cURL.
Códigos de estado HTTP posibles
| Código | Descripción |
|---|---|
| 200 OK | La forma se recuperó correctamente. |
| 400 Bad Request | La solicitud está mal formada o faltan parámetros obligatorios. |
| 401 Unauthorized | La autenticación falló o falta/inválida el token. |
| 404 Not Found | El libro, la hoja o el índice de forma especificados no existen. |
| 500 Internal Server Error | Ocurrió un error inesperado en el servidor. |
Errores comunes: Utilizar un dominio base incorrecto (api.aspose.com) o el segmento obsoleto /autoshapes/ provocará un error 404. Siempre utilice el segmento /shapes/ con el dominio api.aspose.cloud.
Familia de SDK en la nube
Utilizar un SDK es la mejor forma de acelerar el desarrollo. Un SDK gestiona 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 muestran cómo invocar los servicios web de Aspose.Cells mediante diversos SDK:
Para operaciones relacionadas, consulte la documentación sobre Agregar una forma y Actualizar una forma.