Crear un elemento en una lista

Artículo
04/08/2023

Cree un listItem en un recurso list.

Permisos

Se requiere uno de los permisos siguientes para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso	Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa)	Sites.ReadWrite.All
Delegado (cuenta personal de Microsoft)	No admitida.
Aplicación	Sites.ReadWrite.All

Solicitud HTTP

POST /sites/{site-id}/lists/{list-id}/items

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del recurso listItem que quiere crear.

Ejemplo

Aquí se muestra un ejemplo de cómo crear un elemento de lista genérica.

POST /sites/{site-id}/lists/{list-id}/items
Content-Type: application/json

{
  "fields": {
    "Title": "Widget",
    "Color": "Purple",
    "Weight": 32
  }
}

Respuesta

Si se realiza correctamente, este método devuelve un valor listItem en el cuerpo de la respuesta del elemento de lista creado.

HTTP/1.1 201 Created
Content-type: application/json

{
  "id": "20",
  "createdDateTime": "2016-08-30T08:26:00Z",
  "createdBy": {
    "user": {
      "displayName": "Ryan Gregg",
      "id": "8606e4d5-d582-4f5f-aeba-7d7c18b20cfd"
    }
  },
  "lastModifiedDateTime": "2016-08-30T08:26:00Z",
  "lastModifiedBy": {
    "user": {
      "displayName": "Ryan Gregg",
      "id": "8606e4d5-d582-4f5f-aeba-7d7c18b20cfd"
    }
  }
}

Nota: El objeto Response se trunca para obtener una mayor claridad. Se devolverán las propiedades predeterminadas de la llamada actual.

Share via