Créer un élément dans une liste

Article
04/08/2023

Créez une ressource listItem dans une ressource list.

Autorisations

L’une des autorisations suivantes est requise pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation	Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire)	Sites.ReadWrite.All
Déléguée (compte Microsoft personnel)	Non prise en charge.
Application	Sites.ReadWrite.All

Requête HTTP

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

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON de la ressource listItem à créer.

Exemple

Voici un exemple de création d’un élément de liste générique.

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

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

Réponse

Si elle réussit, cette méthode renvoie un objet listItem dans le corps de la réponse pour l’élément de liste créé.

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"
    }
  }
}

Remarque : pour plus de clarté, l’objet de la réponse est tronqué. Toutes les propriétés par défaut sont renvoyées à partir de l’appel réel.

Partager via