Exportar (0) Imprimir
Expandir todo

Introducción al servicio SharePoint 2013 REST

apps for SharePoint

Obtenga información sobre los conceptos básicos del uso del servicio REST de SharePoint 2013 para acceder a los datos de SharePoint y actualizarlos usando los protocolos web estándares REST y OData.

Última modificación: lunes, 15 de julio de 2013

Hace referencia a: SharePoint Foundation 2013 | SharePoint Server 2013

SharePoint 2013 presenta como novedad el servicio de transferencia de estado representacional (REST), que es comparable a los modelos de objetos de cliente de SharePoint existentes. Ahora, los desarrolladores pueden interactuar de forma remota con los datos de SharePoint mediante cualquier tecnología que admita solicitudes web REST. Esto significa que los desarrolladores pueden llevar a cabo operaciones Create, Read, Update y Delete (CRUD) desde sus aplicaciones para SharePoint, soluciones y aplicaciones cliente, con las tecnologías web de REST y la sintaxis del estándar Open Data Protocol (OData).

SharePoint 2013 agrega la posibilidad de interactuar de forma remota con sitios de SharePoint a través de REST. Ahora puede interactuar directamente con objetos de SharePoint a través de cualquier tecnología compatible con las capacidades estándar de REST.

Para obtener acceso a los recursos de SharePoint mediante REST, construya una solicitud HTTP RESTful, por medio del estándar Open Data Protocol (OData), que corresponde a la API deseada de modelo de objetos de cliente. Por ejemplo:

Método de modelo de objetos de cliente:

List.GetByTitle(nombreDeLista)

Extremo de REST:

http://server/site/_api/lists/getbytitle('listname')

El servicio web client.svc de SharePoint controla la solicitud HTTP y emite una respuesta en formato Atom o JSON (notación de objetos JavaScript). La aplicación de cliente analiza después esa respuesta. En la siguiente figura se muestra una vista de alto nivel de la arquitectura REST de SharePoint.

Arquitectura de servicio REST de SharePoint

Arquitectura de servicio REST de SharePoint

Dadas las funciones y la facilidad de uso que los modelos de objetos de clientes proporcionan, continúan siendo la opción primaria de desarrollo para comunicarse con sitios de SharePoint a través de código administrado .NET Framework, Silverlight o JavaScript.

Uso de comandos HTTP con el servicio REST de SharePoint 2013

Para usar las funciones de REST que están integradas en SharePoint 2013, construya una solicitud HTTP RESTful, usando el estándar OData, que corresponde a la API del modelo de objetos de cliente que quiere usar. El servicio web client.svc administra la solicitud HTTP y envía la respuesta correspondiente en formato Atom o notación de objetos JavaScript (JSON). Después, la aplicación cliente debe analizar esa respuesta.

Los extremos del servicio REST de SharePoint 2013 corresponden a los tipos y miembros de los modelos de objetos de cliente de SharePoint. Si usa solicitudes HTTP, puede usar estos extremos REST para realizar las operaciones CRUD típicas en entidades de SharePoint, como listas y sitios.

En general:

Si desea usar esto en un extremo

Use esta solicitud de HTTP

Recuerde

Leer un recurso

GET

Crear o actualizar un recurso

POST

Use POST para crear entidades como listas y sitios. El servicio REST de SharePoint 2013 permite el envío de comandos POST que incluyan definiciones de objetos a extremos que representen colecciones.

Para tareas POST, toda propiedad innecesaria se establece en sus valores predeterminados. Si trata de establecer una propiedad de solo lectura como parte de una tarea POST, el servicio devuelve una excepción.

Actualizar o insertar un recurso

PUT

Use operaciones PUT y MERGE para actualizar objetos de SharePoint existentes.

Los extremos de servicios que representan una operación set de propiedades de objeto admiten tanto solicitudes PUT como solicitudes MERGE.

  • En el caso de solicitudes MERGE, configurar las propiedades será opcional; de manera que aquellas que no defina explícitamente retendrán la propiedad actual.

  • Para solicitudes PUT, si no especifica todas las propiedades requeridas en actualizaciones de objetos, el servicio REST devuelve una excepción. Además, cualquier propiedad opcional que no establezca explícitamente se establece en sus propiedades predeterminadas.

Eliminar un recurso

DELETE

Use el comando DELETE HTTP con la dirección URL específica del extremo para eliminar el objeto de SharePoint representado por dicho extremo.

En el caso de objetos reciclables, como listas, archivos y elementos de lista, esto da como resultado una tarea Recycle.

Construir direcciones URL de REST para acceder a recursos de SharePoint

Cada vez que sea posible, el URI de estos extremos de REST imita rigurosamente la firma de la API del recurso en el modelo de objetos de cliente de SharePoint. Los puntos de entrada principales para el servicio REST representan la colección de sitios y el sitio del contexto especificado.

Para obtener acceso a una colección de sitios específica, use la siguiente construcción:

http://server/site/_api/site

Para obtener acceso a un sitio específico, use la siguiente construcción:

http://server/site/_api/web

En cada caso, server representa el nombre del servidor, y site representa el nombre del sitio específico o la ruta de acceso a dicho sitio.

Desde este punto de partida, puede construir URI REST más específicas al "caminar" el modelo de objetos, con el uso de los nombres de las API del modelo de objetos de clientes separados por una barra diagonal (/).

Esta sintaxis no se aplica a las API SocialFeedManager o SocialFollowingManager de REST. Para más información, vea Referencia de la API de REST de SharePoint 2013 de fuente de social y Siguientes personas y el contenido de la referencia de la API de REST de SharePoint 2013.

Para obtener más pautas generales para determinar los URI de extremos de REST de SharePoint a partir de la firma de las API del modelo de objetos de clientes correspondiente, vea Determinar los URI de extremo de REST de SharePoint.

La tabla siguiente contiene ejemplos típicos de direcciones URL de extremo REST para que empiece a trabajar con SharePoint. Anteponga http://server/site/_api/ a los fragmentos de URL que se muestran en la tabla para construir una dirección URL REST completa. Cuando es necesario para los comandos POST, la tabla contiene muestras de datos que puede pasar en el cuerpo de la solicitud HTTP para crear el elemento de SharePoint especificado. Los elementos en cursiva representan las variables que debe reemplazar con sus valores.

Descripción

Extremo URL

Método HTTP

Contenido del cuerpo

Recupera el título de una lista

web/title

GET

No es aplicable

Recupera todas las listas de un sitio

lists

GET

No es aplicable

Recupera los metadatos de una sola lista

lists/getbytitle('listname')

GET

No es aplicable

Recupera los elementos de una lista

lists/getbytitle('listname')/items

GET

No es aplicable

Recupera una propiedad específica de un documento. (En este caso, el título del documento).

lists/getbytitle('listname')?select=Title

GET

No es aplicable

Crea una lista

lists

POST

{
  '_metadata':{'type':SP.List},
  'AllowContentTypes': true,
  'BaseTemplate': 104,
  'ContentTypesEnabled': true,
  'Description': 'My list description',
  'Title': 'RestTest'
}

Agrega un elemento a una lista

lists/getbytitle('listname')/items

POST

{
  '_metadata':{'type':SP. listnameListItem},
  'Title': 'MyItem'
}

Use los siguientes recursos para aprender más cosas sobre el uso del servicio REST de SharePoint.

Procedimiento para realizar operaciones básicas con extremos REST de SharePoint 2013

Aprenda a realizar operaciones básicas de creación, lectura, actualización y eliminación (CRUD) con la interfaz REST de SharePoint 2013.

Trabajar con listas y elementos de lista con REST

Aprenda a realizar operaciones básicas de creación, lectura, actualización y eliminación (CRUD) en listas y elementos de listas con la interfaz REST de SharePoint 2013.

Trabajar con carpetas y archivos con REST

Aprenda a realizar operaciones básicas de creación, lectura, actualización y eliminación (CRUD) en carpetas y archivos con la interfaz REST de SharePoint 2013.

Navegar por la estructura de datos de SharePoint representada en el servicio REST

Aprenda a iniciar desde un extremo de REST para un determinado elemento de SharePoint, y a navegar hasta elementos relacionados y acceder a ellos, como pueden ser sitios primarios o la estructura de biblioteca en la que reside dicho elemento.

Determinar los URI de extremo de REST de SharePoint

Aprenda las pautas generales para determinar los URI de extremo de REST de SharePoint a partir de la firma de las API del modelo de objetos de clientes correspondiente.

Usar operaciones de consulta de OData en solicitudes REST de SharePoint

Aprenda a usar una amplia variedad de operadores de cadenas de consultas OData para seleccionar, filtrar y ordenar los datos solicitados del servicio REST de SharePoint.

API de REST, extremos y ejemplos de SharePoint 2013

Esta página contiene vínculos a todos los recursos de REST que hay disponibles para desarrolladores de SharePoint 2013 en MSDN.

Introducción a la API de REST de búsqueda de SharePoint

Agregue la función de búsqueda al cliente y aplicaciones móviles mediante el servicio de búsqueda REST en SharePoint Server 2013 y de cualquier tecnología que es compatible con las solicitudes web REST.

Referencia de la API de REST de SharePoint 2013 de fuente de social

Aprenda sobre el uso de extremos de REST de SharePoint 2013 para tareas relacionadas con fuentes.

Siguientes personas y el contenido de la referencia de la API de REST de SharePoint 2013

Aprenda sobre el uso de extremos de REST de SharePoint 2013 para seguir a gente y contenido.

Mostrar:
© 2014 Microsoft