Obtener una propiedad específica de un documento
Esta API REST lee una propiedad de documento por su nombre.
API REST
GET https://api.aspose.cloud/v3.0/cells/{name}/documentproperties/{propertyName}
Parámetros de la solicitud
| Nombre del parámetro | Tipo | Ubicación | Descripción |
|---|---|---|---|
| name | string | path | El nombre del archivo de Excel. |
| propertyName | string | path | El nombre de la propiedad de documento a recuperar. |
| folder | string | query | La carpeta que contiene el archivo (opcional). |
| storageName | string | query | El nombre del almacenamiento (opcional). |
La Especificación OpenAPI define una interfaz de programación accesible públicamente y permite llevar a cabo 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 llamadas a la API en la nube mediante cURL.
Detalles de la respuesta
El objeto JSON devuelto por la API contiene los siguientes campos:
| Campo | Tipo | Descripción |
|---|---|---|
| DocumentProperty.Name | string | El nombre de la propiedad (por ejemplo, Author). |
| DocumentProperty.Value | string | El valor de la propiedad. Puede estar vacío si no está establecido. |
| DocumentProperty.BuiltIn | boolean | Indica si la propiedad es una propiedad integrada de Excel. |
| DocumentProperty.link.Href | string | URL relativa al recurso de la propiedad. |
| DocumentProperty.link.Rel | string | Tipo de relación, generalmente self. |
| DocumentProperty.link.Title | string | Título legible (puede ser null). |
| DocumentProperty.link.Type | string | Tipo MIME del recurso vinculado (puede ser null). |
| Code | integer | Código de estado HTTP devuelto por el servicio. |
| Status | string | Descripción textual del estado (por ejemplo, OK). |
Respuestas de error
| Estado HTTP | Código | Descripción |
|---|---|---|
| 400 | InvalidParameter |
Uno o más parámetros de la solicitud son inválidos. |
| 401 | AuthenticationFailed |
Token JWT ausente o inválido. |
| 404 | PropertyNotFound |
La propiedad de documento especificada no existe. |
| 500 | InternalError |
Se produjo un error inesperado en el servidor. |
Un cuerpo de error típico tiene el siguiente aspecto:
{
"Code": 404,
"Status": "Property not found"
}
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 para que usted se enfoque en las tareas de su proyecto. Consulte el repositorio de GitHub para obtener una lista completa de los SDK de Aspose.Cells Cloud.
Los siguientes ejemplos de código muestran cómo realizar llamadas a los servicios web de Aspose.Cells utilizando diversos SDK:
Terminología
| Término | Definición |
|---|---|
| Propiedad de documento | Un fragmento de metadatos asociado a un libro de Excel (por ejemplo, Autor, Título, Creado). |
| Metadatos | Término general para datos que describen otros datos; en este contexto se refiere a propiedades de documento. |
| Propiedad personalizada | Una propiedad definida por el usuario que no está incluida en el conjunto integrado. |
Preguntas frecuentes
P: ¿Cómo puedo recuperar la propiedad Autor de un archivo de Excel almacenado en Aspose Cloud?
R: Envíe una solicitud GET a https://api.aspose.cloud/v3.0/cells/{nombrearchivo}/documentproperties/author con un token Bearer válido. La respuesta JSON incluye DocumentProperty.Name = "Author" y su Value.
P: ¿Qué error devuelve la API si la propiedad solicitada no existe?
R: La API devuelve HTTP 404 con un cuerpo JSON que contiene Code: 404 y Status: "Property not found".
P: ¿Necesito especificar storageName cuando el archivo está en el almacenamiento predeterminado?
R: No. El parámetro de consulta storageName es opcional; omitálo para utilizar el almacenamiento predeterminado configurado para su cuenta.