---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# API de réservation multiple WSD

# API de réservation multiple WSD {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 16 minutes de lecture

L'API Prestation de services sur le lieu de travail de réservation multiple (WSD) fournit des points de terminaison pour la gestion des réservations avec plusieurs emplacements de lieu de travail.
Pour accéder à cette API, l'appelant doit avoir le rôle sn_wsd_core.workplace_user et les modules d'extension Workplace Safety Management (sn_wsd_core) et Workplace Reservation Management (sn_wsd_rsv) doivent être activés.

Cette API s'exécute dans l'espace `de noms sn_wsd_rsv` .

Pour plus d'informations sur , reportez-vous à Gestion des réservations du lieu de travail[la rubrique Gestion des réservations du lieu de travail](https://www.servicenow.com/docs/access?context=workplace-rsv-mgmt-feat&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US).

## Réservation multiple WSD : PATCH/API/sn_wsd_rsv/multi_reservation/cancel/{sys_id} {#ariaid-title2}

Annule une réservation multiple spécifiée.
<br />

### Format d'URL

URL versionnée : /api/sn_wsd_rsv/{api_version}/multi_reservation/cancel/{sys_id}

URL par défaut : /api/sn_wsd_rsv/multi_reservation/cancel/{sys_id}

### Paramètres de demande pris en charge

{#wsd_multi_reserv-PATCH-cancel__entry__2}{#wsd_multi_reserv-PATCH-cancel__version-RESTAPI}

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
| sys_id | Sys_id de la multi-réservation à annuler. Situé dans la table Réservation du lieu de travail \[sn_wsd_rsv_reservation\]. Type de données : chaîne |
[Tableau 1. Paramètres de chemin d'accès]

{#wsd_multi_reserv-PATCH-cancel__entry__8}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 2. Paramètres de requête]

{#wsd_multi_reserv-PATCH-cancel__entry__12}

| Nom | Description |
|-|-|
| cancel_notes | Motif de l'annulation de la réservation. Type de données : chaîne |
[Tableau 3. Paramètres du corps de la demande]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#wsd_multi_reserv-PATCH-cancel__entry__16}{#wsd_multi_reserv-PATCH-cancel__accept-reserv-entry}{#wsd_multi_reserv-PATCH-cancel__content_type-JSON-only-entry-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la demande. Types pris en charge : application/json, application/xml ou, text/xml. Valeur par défaut : application/json |
| Content-Type | Format de données du corps de la demande. Prend uniquement en charge application/json. |
[Tableau 4. En-têtes de demandes]

{#wsd_multi_reserv-PATCH-cancel__entry__22}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 5. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#wsd_multi_reserv-PATCH-cancel__entry__26}{#wsd_multi_reserv-PATCH-cancel__entry-200-status-code}{#wsd_multi_reserv-PATCH-cancel__entry-401-status-code}{#wsd_multi_reserv-PATCH-cancel__entry-404-status-code}{#wsd_multi_reserv-PATCH-cancel__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été correctement traitée. |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 404 | Introuvable. L'élément demandé est introuvable. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 6. Codes d'état]

### Paramètres du corps de réponse

{#wsd_multi_reserv-PATCH-cancel__entry__36}{#wsd_multi_reserv-PATCH-cancel__parent-multi-entry}

| Nom | Description |
|-|-|
| résultat | Détails des résultats de la demande d'annulation. Type de données : objet "result": { "error": "String", "parent": "String", "success": Boolean, "successfulReservations": [Array], "unSuccessfulReservations": [Array] } |
| Résultat.Erreur | Message décrivant l'erreur associée. Type de données : chaîne |
| résultat.parent | Sys_id de la réservation parente. Un parent peut avoir une ou plusieurs réservations enfants qui lui sont associées. Type de données : chaîne |
| résultat.succès | Marqueur indiquant si la réservation a été annulée avec succès. Valeurs possibles : * true : annulé avec succès. * faux : la réservation n'a pas été annulée. Type de données : booléennes |
| résultat.reservationsréussies | Détails sur l'annulation réussie de la multi-réservation. Type de données : tableau d'objets "successfulReservations": [ { "msg": "String", "success": Boolean, "sys_id": "String" } ] |
| result.successfulReservations.msg | Message d'annulation. Type de données : chaîne |
| résultat.succèsRéservations.succès | Marqueur indiquant sila réservation a été annulée. Valeurs possibles : * true : annulé avec succès. * false : échec de l'opération. Type de données : booléennes |
| result.successfulReservations.sys_id | Sys_id de la réservation qui a été annulée. Situé dans la table Réservation du lieu de travail \[sn_wsd_rsv_reservation\]. Type de données : chaîne |
| résultat.unSuccessfulReservations | Détails sur l'annulation infructueuse de la multi-réservation. Type de données : tableau d'objets "unSuccessfulReservations": [ { "msg": "String", "success": Boolean, "sys_id": "String" } ] |
| result.unSuccessfulReservations.msg | Message d'annulation. Type de données : chaîne |
| résultat.unSuccessfulReservations.success | Marqueur indiquant si la réservation a été annulée avec succès. Valeurs possibles : * true : annulé avec succès. * false : échec de l'opération. Type de données : booléennes |
| result.unSuccessfulReservations.sys_id | Sys_id de la réservation qui n'a pas été annulée. Situé dans la table Réservation du lieu de travail \[sn_wsd_rsv_reservation\]. Type de données : chaîne |
[ ]

### Demande cURL

L'exemple de code suivant montre comment annuler une multi-réservation.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/cancel/1b1fdf5987ab01506342b846dabb35ec" \
    --request PATCH \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{\"cancel_notes\":\"Meeting no longer needed.\"}" \ 
    --user "username":"password'"

Résultats renvoyés :

    {
      "result": {
        "success": true,
        "successfulReservations": [
          {
            "success": true,
            "msg": "Cancelled successfully.",
            "sys_id": "5b1f9f1d87ab01506342b846dabb35a4"
          },
          {
            "success": true,
            "msg": "Cancelled successfully.",
            "sys_id": "931f9f1d87ab01506342b846dabb35a0"
          }
        ],
        "unSuccessfulReservations": [],
        "error": null,
        "parent": "1b1fdf5987ab01506342b846dabb35ec"
      }
    }

## Réservation multiple WSD : PATCH /api/sn_wsd_rsv/multi_reservation/update/{sys_id} {#ariaid-title3}

Met à jour les réservations associées à une multi-réservation où la même réservation (réunion) a plusieurs emplacements de lieu de travail.
Ce point de terminaison peut gérer quatre scénarios de mise à jour différents :

1. Mettez à jour le contenu de l'enregistrement de réservation multiple, tel que l'objet, la date ou l'heure.
2. Convertissez la multi-réservation en une réservation unique basée sur le parent (réservation pour un seul emplacement de lieu de travail).
3. Convertir une réservation unique (réservation pour un seul emplacement de lieu de travail) en une réservation multiple.
4. Ajoutez ou supprimez un emplacement de lieu de travail à une multi-réservation existante.

### Format d'URL

URL versionnée : /api/sn_wsd_rsv/{api_version}/multi_reservation/update/{sys_id}

URL par défaut : /api/sn_wsd_rsv/multi_reservation/update/{sys_id}

### Paramètres de demande pris en charge

{#wsd_multi_reserv-PATCH-update__entry__2}{#wsd_multi_reserv-PATCH-update__version-RESTAPI}

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
| sys_id | Sys_id de la réservation à mettre à jour. * Réservation unique à réservation multiple : Sys_id de la réservation unique. Situé dans la table Réservation du lieu de travail \[sn_wsd_rsv_reservation\]. * Mettre à jour le contenu de la réservation multiple : Sys_id de l'enregistrement de réservation parent. Situé dans la table Réservation du lieu de travail \[sn_wsd_rsv_reservation\]. Pour obtenir les détails d'une réservation parente multiple à partir de l'enregistrement enfant, consultez les sys_id dans le champ source_reservation de l'enregistrement enfant. Type de données : chaîne |
[Tableau 7. Paramètres de chemin d'accès]

{#wsd_multi_reserv-PATCH-update__entry__8}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 8. Paramètres de requête]

{#wsd_multi_reserv-PATCH-update__entry__12}{#wsd_multi_reserv-PATCH-update__end-update_reserv-entry}{#wsd_multi_reserv-PATCH-update__requested_for-update_reserv-entry}{#wsd_multi_reserv-PATCH-update__reservable_module-update_reserv-entry}{#wsd_multi_reserv-PATCH-update__shift-update_reserv-entry}{#wsd_multi_reserv-PATCH-update__start-update_reserv-entry}

| Nom | Description |
|-|-|
| fin | Requis si le shift paramètre n'est pas transmis. Heure de fin de la réservation demandée. Type de données : chaîne Format : UTC ou heure locale (aaaa-mm-jj hh :mm :ss) |
| requested_for | Sys_id ou adresse e-mail de l'utilisateur pour lequel la réservation est effectuée. Situé dans la table Utilisateur \[sys_user\]. Type de données : chaîne |
| réservables | Liste de détails sur les réservables associés à la réservation. Type de données : tableau d'objets "reservables": [ { "is_private": Boolean, "sys_id": "String" } ] |
| reservables.is_private | Marqueur indiquant si la réservation est privée. Si elle est privée, la réservation n'apparaît à personne d'autre qu'au propriétaire. Pour plus d'informations sur ces paramètres de confidentialité, consultez [la section Paramètres de confidentialité de la localisation et impact](https://www.servicenow.com/docs/access?context=location-privacy-settings-and-impact&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US). Valeurs valides : * true : la réservation est privée. * faux : la réservation n'est pas privée. Type de données : booléennes Par défaut : valeur définie pour la confidentialité dans les propriétés système. |
| reservables.sys_id | Sys_id de l'emplacement où effectuer les réservations. Situé dans la table Emplacement du lieu de travail \[sn_wsd_core_workplace_location\]. Type de données : chaîne |
| reservable_module | Requis. Sys_id du module réservable à associer à la réservation. Un [module réservable](https://www.servicenow.com/docs/access?context=config-reservable-module&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US) définit les éléments d'espace de travail nécessaires pour une réservation. Situé dans la table Module réservable \[sn_wsd_rsv_reservable_module\]. Type de données : chaîne |
| Période de travail | Sys_id de l'équipe à associer à la réservation. Situé dans la table Équipe \[sn_wsd_core_shift\]. Si ce paramètre est transmis, il end n'est pas obligatoire. Pour plus d'informations sur les réservations basées sur l'équipe, consultez [Activer la réservation basée sur l'équipe](https://www.servicenow.com/docs/access?context=wsd-reservation-setup&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US). Type de données : chaîne |
| début | Requis. A demandé l'heure de début de la réservation. Type de données : chaîne Format : UTC ou heure locale (aaaa-mm-jj hh :mm :ss) |
| objet | Objet de la réunion associée à la réservation. Type de données : chaîne |
[Tableau 9. Paramètres du corps de la demande]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#wsd_multi_reserv-PATCH-update__entry__32}{#wsd_multi_reserv-PATCH-update__accept-reserv-entry}{#wsd_multi_reserv-PATCH-update__content_type-JSON-only-entry-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la demande. Types pris en charge : application/json, application/xml ou, text/xml. Valeur par défaut : application/json |
| Content-Type | Format de données du corps de la demande. Prend uniquement en charge application/json. |
[Tableau 10. En-têtes de demandes]

{#wsd_multi_reserv-PATCH-update__entry__38}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 11. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#wsd_multi_reserv-PATCH-update__entry__42}{#wsd_multi_reserv-PATCH-update__entry-200-status-code}{#wsd_multi_reserv-PATCH-update__entry-401-status-code}{#wsd_multi_reserv-PATCH-update__entry-404-status-code}{#wsd_multi_reserv-PATCH-update__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été correctement traitée. |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 404 | Introuvable. L'élément demandé est introuvable. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 12. Codes d'état]

### Paramètres du corps de réponse

{#wsd_multi_reserv-PATCH-update__entry__52}{#wsd_multi_reserv-PATCH-update__result-multi-entry}{#wsd_multi_reserv-PATCH-update__parent-multi-entry}{#wsd_multi_reserv-PATCH-update__success-multi-entry}{#wsd_multi_reserv-PATCH-update__successfulReservations_error-multi-entry}{#wsd_multi_reserv-PATCH-update__successfulReservations_reservable-multi-entry}{#wsd_multi_reserv-PATCH-update__successfulReservations_sys_id-multi-entry}{#wsd_multi_reserv-PATCH-update__unSuccessfulReservations_error-multi-entry}{#wsd_multi_reserv-PATCH-update__unSuccessfulReservations_reservable-multi-entry}{#wsd_multi_reserv-PATCH-update__unSuccessfulReservations_success-multi-entry}{#wsd_multi_reserv-PATCH-update__unSuccessfulReservations_sy_id-multi-entry}

| Nom | Description |
|-|-|
| résultat | Renvoyer les résultats de la création ou de la mise à jour de plusieurs réservations. Type de données : objet "result": { "parent": "String", "success": Boolean, "successfulReservations": Array, "unSuccessfulReservations": Array } |
| résultat.parent | Sys_id de la réservation parente. Un parent peut avoir une ou plusieurs réservations enfants qui lui sont associées. Type de données : chaîne |
| résultat.succès | Marqueur indiquant si la réservation a été créée avec succès. Valeurs possibles : * true : créé avec succès. * false : échec de l'opération. Type de données : booléennes |
| résultat.reservationsréussies | Liste des réservations qui ont été créées avec succès. Type de données : tableau "successfulReservations": [ { "cancelled": Boolean, "error": "String", "reservable": "String" "success": Boolean, "sys_id": "String", "updated": Boolean } ] |
| résultat.reservations.réussies.annulées | Marqueur indiquant si la réservation a été annulée avec succès. Valeurs possibles : * true : annulé avec succès. * false : non annulé. Type de données : booléennes |
| résultat.successfulreservations.error | Message d'erreur si un problème s'est produit lors de la création de la réservation. Type de données : chaîne |
| résultat. SuccessfulReservations.insert | Marqueur indiquant si la réservation a été correctement insérée. Par exemple, lorsqu'une réservation est ajoutée. Valeurs possibles : * vrai : inséré avec succès. * false : échec de l'opération. Type de données : booléennes |
| résultat.reservationsréussies.réservable | Sys_id du lieu de travail pour lequel la réservation a été effectuée. Situé dans la table Emplacement du lieu de travail \[sn_wsd_core_workplace_location\]. Type de données : chaîne |
| résultat.succèsRéservations.succès | Marqueur indiquant si l'opération associée a réussi. Valeurs possibles : * true : l'opération a réussi. * false : échec de l'opération. Type de données : booléennes |
| result.successfulReservations.sys_id | Sys_id de la réservation qui a été créée. Situé dans la table Réservation du lieu de travail \[sn_wsd_rsv_reservation\]. Type de données : chaîne |
| résultat.reservations.réussies.mettre à jour | Marqueur indiquant si la réservation a été mise à jour avec succès. Valeurs possibles : * true : mis à jour avec succès. * false : non mis à jour. Type de données : booléennes |
| résultat.unSuccessfulReservations | Liste des réservations qui ont échoué. Type de données : tableau "unSuccessfulReservations": [ { "cancelled": Boolean, "error": "String", "insert": Boolean "reservable": "String" "success": Boolean, "sys_id": "String", "updated": Boolean } ] |
| résultat.unSuccessfulReservations.annulé | Marqueur indiquant si la réservation a été annulée avec succès. Valeurs possibles : * true : annulé avec succès. * false : non annulé. Type de données : booléennes |
| résultat.unSuccessfulReservations.error | Message d'erreur si un problème s'est produit lors de la création de la réservation. Type de données : chaîne |
| result.unSuccessfulReservations.insert | Marqueur indiquant si la réservation a été correctement insérée. Valeurs possibles : * vrai : inséré avec succès. * false : échec de l'opération. Type de données : booléennes |
| résultat.unSuccessfulReservations.reservable | Sys_id du lieu de travail pour lequel la réservation essayait d'être effectuée. Situé dans la table Emplacement du lieu de travail \[sn_wsd_core_workplace_location\]. Type de données : chaîne |
| résultat.unSuccessfulReservations.success | Marqueur indiquant si la réservation a été créée avec succès. Valeurs possibles : * true : créé avec succès. * false : échec de l'opération. Type de données : booléennes |
| result.unSuccessfulReservations.sys_id | Sys_id de la réservation qui a échoué. Toujours null. Type de données : chaîne |
| résultat.unSuccessfulReservations.update | Marqueur indiquant si la réservation a été mise à jour avec succès. Valeurs possibles : * true : mis à jour avec succès. * false : non mis à jour. Type de données : booléennes |
[ ]

### Demande cURL

L'exemple de code suivant montre comment modifier le contenu d'une multi-réservation existante.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/update/02000d4edb7650106c731dcd13961914" \
    --request PATCH \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
        \"reservables\":[
            { 
                \"sys_id\":\"fe1f744edb7650106c731dcd139619ca\" 
            }, 
            {
                \"sys_id\":\"02000d4edb7650106c731dcd13961914\"
            }
        ],
        \"reservable_module\":\"c31241cedb7650106c731dcd13961917\",
        \"subject\":\"Test 1\",
        \"start\":\"2022-05-27 13:00:00\",
        \"end\":\"2022-05-27 14:00:00\",
        \"requested_for\": \"workplace_user@example.com\"
    }" \
    --user 'username':'password'

Résultats renvoyés :

    {
      "result": {
        "parent": "98ccb4348723cd106342b846dabb359a",
        "success": true,
        "successfulReservations": [
          {
            "success": true,
            "updated": true,
            "cancelled": false,
            "sys_id": "6cccb4348723cd106342b846dabb359d",
            "error": null,
            "reservable": "5eafb44edb7650106c731dcd13961943"
          },
          {
            "success": true,
            "updated": true,
            "cancelled": false,
            "sys_id": "74af283c87ef8d106342b846dabb3592",
            "error": null,
            "reservable": "fe1f744edb7650106c731dcd139619ca"
          }
        ],
        "unSuccessfulReservations": []
      }
    }

### Demande cURL

L'exemple de code suivant montre comment ajouter un emplacement de lieu de travail à une multi-réservation existante.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/update/02000d4edb7650106c731dcd13961914" \
    --request PATCH \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
       \"reservables\":[
           { 
               \"sys_id\":\"fe1f744edb7650106c731dcd139619ca\",
               \"is_private\": false 
           }, 
           {
               \"sys_id\":\"5eafb44edb7650106c731dcd13961943\",
               \"is_private\": false
           },
        {
               \"sys_id\":\"c4308d4edb7650106c731dcd1396194c\",
               \"is_private\": false
           }
       ],
       \"reservable_module\":\"c31241cedb7650106c731dcd13961917\",
       \"subject\":\"Test 1\",
       \"start\":\"2022-05-27 13:00:00\",
       \"end\":\"2022-05-27 14:00:00\",
       \"requested_for\": \"workplace_user@example.com\"
    }" \
    --user 'username':'password'

Résultats renvoyés :

    {
      "result": {
        "parent": "98ccb4348723cd106342b846dabb359a",
        "success": true,
        "successfulReservations": [
          {
            "success": true,
            "updated": true,
            "cancelled": false,
            "sys_id": "6cccb4348723cd106342b846dabb359d",
            "error": null,
            "reservable": "5eafb44edb7650106c731dcd13961943"
          },
          {
            "success": true,
            "updated": true,
            "cancelled": false,
            "sys_id": "74af283c87ef8d106342b846dabb3592",
            "error": null,
            "reservable": "fe1f744edb7650106c731dcd139619ca"
          },
          {
            "success": true,
            "inserted": true,
            "sys_id": "9e6d78748723cd106342b846dabb35a5",
            "error": null,
            "reservable": "c4308d4edb7650106c731dcd1396194c"
          }
        ],
        "unSuccessfulReservations": []
      }
    }

### Demande cURL

L'exemple de code suivant montre comment convertir une réservation unique en réservation multiple.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/update/02000d4edb7650106c731dcd13961914" \
    --request PATCH \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
       \"reservables\":[
           { 
               \"sys_id\":\"fe1f744edb7650106c731dcd139619ca\",
               \"is_private\": false
           }, 
           {
               \"sys_id\":\"5eafb44edb7650106c731dcd13961943\",
               \"is_private\": false
           }
       ],
       \"reservable_module\":\"c31241cedb7650106c731dcd13961917\",
       \"subject\":\"Test 1\",
       \"start\":\"2022-05-27 13:00:00\",
       \"end\":\"2022-05-27 14:00:00\",
       \"requested_for\": \"workplace_user@example.com\"
    }" \
    --user 'username':'password'

Résultats renvoyés :

    {
      "result": {
        "success": true,
        "parent": "98ccb4348723cd106342b846dabb359a",
        "successfulReservations": [
          {
            "success": true,
            "inserted": true,
            "sys_id": "6cccb4348723cd106342b846dabb359d",
            "error": null,
            "reservable": "5eafb44edb7650106c731dcd13961943"
          },
          {
            "success": true,
            "insert": false,
            "update": true,
            "cancel": false,
            "sys_id": "74af283c87ef8d106342b846dabb3592",
            "reservable": "fe1f744edb7650106c731dcd139619ca"
          }
        ],
        "unSuccessfulReservations": [],
        "error": null
      }
    }

### Demande cURL

L'exemple de code suivant montre comment convertir une réservation multiple en une réservation unique.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/update/02000d4edb7650106c731dcd13961914" \
    --request PATCH \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
       \"reservables\":[
           { 
               \"sys_id\":\"fe1f744edb7650106c731dcd139619ca\",
               \"is_private\": false
           }
       ],
       \"reservable_module\":\"c31241cedb7650106c731dcd13961917\",
       \"subject\":\"Test 1\",
       \"start\":\"2022-05-27 13:00:00\",
       \"end\":\"2022-05-27 14:00:00\",
       \"requested_for\": \"workplace_user@example.com\"
    }" \
    --user 'username':'password'

Résultats renvoyés :

    {
      "result": {
        "sys_id": "74af283c87ef8d106342b846dabb3592",
        "success": true,
        "successfulReservations": [
          {
            "success": true,
            "insert": false,
            "update": true,
            "cancel": false,
            "sys_id": "74af283c87ef8d106342b846dabb3592",
            "reservable": "fe1f744edb7650106c731dcd139619ca",
            "error": ""
          },
          {
            "success": true,
            "insert": false,
            "update": true,
            "cancel": true,
            "sys_id": "3caf283c87ef8d106342b846dabb3596",
            "reservable": "5eafb44edb7650106c731dcd13961943"
          }
        ],
        "unSuccessfulReservations": [],
        "error": null
      }
    }

## Réservation multiple WSD : POST/API/sn_wsd_rsv/multi_reservation/add {#ariaid-title4}

Crée des réservations de lieu de travail pour la même durée à différents emplacements de travail.
<br />

### Format d'URL

URL versionnée : /api/sn_wsd_rsv/{api_version}/multi_reservation/add

URL par défaut : /api/sn_wsd_rsv/multi_reservation/add

### Paramètres de demande pris en charge

{#wsd_multi_reserv-POST-add__entry__2}{#wsd_multi_reserv-POST-add__version-RESTAPI}

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
[Tableau 13. Paramètres de chemin d'accès]

{#wsd_multi_reserv-POST-add__entry__6}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 14. Paramètres de requête]

{#wsd_multi_reserv-POST-add__entry__10}{#wsd_multi_reserv-POST-add__end-update_reserv-entry}{#wsd_multi_reserv-POST-add__requested_for-update_reserv-entry}{#wsd_multi_reserv-POST-add__reservable_module-update_reserv-entry}{#wsd_multi_reserv-POST-add__shift-update_reserv-entry}{#wsd_multi_reserv-POST-add__start-update_reserv-entry}{#wsd_multi_reserv-POST-add__subject-update_reserv-entry}

| Nom | Description |
|-|-|
| fin | Requis si le shift paramètre n'est pas transmis. Heure de fin de la réservation demandée. Type de données : chaîne Format : UTC ou heure locale (aaaa-mm-jj hh :mm :ss) |
| requested_for | Sys_id ou adresse e-mail de l'utilisateur pour lequel la réservation est effectuée. Situé dans la table Utilisateur \[sys_user\]. Type de données : chaîne |
| réservables | Liste de détails sur les réservables associés à la réservation. Type de données : tableau d'objets "reservables": [ { "is_private": Boolean, "sys_id": "String" } ] |
| reservables.is_private | Marqueur indiquant si la réservation est privée. Si elle est privée, la réservation n'apparaît à personne d'autre qu'au propriétaire. Pour plus d'informations sur ces paramètres de confidentialité, consultez [la section Paramètres de confidentialité de la localisation et impact](https://www.servicenow.com/docs/access?context=location-privacy-settings-and-impact&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US). Valeurs valides : * true : la réservation est privée. * faux : la réservation n'est pas privée. Type de données : booléennes Par défaut : valeur définie pour la confidentialité dans les propriétés système. |
| reservables.sys_id | Sys_id de l'emplacement où effectuer les réservations. Situé dans la table Emplacement du lieu de travail \[sn_wsd_core_workplace_location\]. Type de données : chaîne |
| reservable_module | Requis. Sys_id du module réservable à associer à la réservation. Un [module réservable](https://www.servicenow.com/docs/access?context=config-reservable-module&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US) définit les éléments d'espace de travail nécessaires pour une réservation. Situé dans la table Module réservable \[sn_wsd_rsv_reservable_module\]. Type de données : chaîne |
| Période de travail | Sys_id de l'équipe à associer à la réservation. Situé dans la table Équipe \[sn_wsd_core_shift\]. Si ce paramètre est transmis, il end n'est pas obligatoire. Pour plus d'informations sur les réservations basées sur l'équipe, consultez [Activer la réservation basée sur l'équipe](https://www.servicenow.com/docs/access?context=wsd-reservation-setup&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US). Type de données : chaîne |
| début | Requis. A demandé l'heure de début de la réservation. Type de données : chaîne Format : UTC ou heure locale (aaaa-mm-jj hh :mm :ss) |
| objet | Requis. Objet de la réunion associée à la réservation. Type de données : chaîne |
[Tableau 15. Paramètres du corps de la demande]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#wsd_multi_reserv-POST-add__entry__30}{#wsd_multi_reserv-POST-add__accept-reserv-entry}{#wsd_multi_reserv-POST-add__content_type-JSON-only-entry-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la demande. Types pris en charge : application/json, application/xml ou, text/xml. Valeur par défaut : application/json |
| Content-Type | Format de données du corps de la demande. Prend uniquement en charge application/json. |
[Tableau 16. En-têtes de demandes]

{#wsd_multi_reserv-POST-add__entry__36}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 17. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#wsd_multi_reserv-POST-add__entry__40}{#wsd_multi_reserv-POST-add__entry-200-status-code}{#wsd_multi_reserv-POST-add__entry-401-status-code}{#wsd_multi_reserv-POST-add__entry-404-status-code}{#wsd_multi_reserv-POST-add__entry-500-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été correctement traitée. |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 404 | Introuvable. L'élément demandé est introuvable. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 18. Codes d'état]

### Paramètres du corps de réponse

{#wsd_multi_reserv-POST-add__entry__50}{#wsd_multi_reserv-POST-add__result-multi-entry}{#wsd_multi_reserv-POST-add__parent-multi-entry}{#wsd_multi_reserv-POST-add__success-multi-entry}{#wsd_multi_reserv-POST-add__successfulReservations-multi-entry}{#wsd_multi_reserv-POST-add__successfulReservations_error-multi-entry}{#wsd_multi_reserv-POST-add__successfulReservations_inserted-multi-entry}{#wsd_multi_reserv-POST-add__successfulReservations_reservable-multi-entry}{#wsd_multi_reserv-POST-add__successfulReservations_success-multi-entry}{#wsd_multi_reserv-POST-add__successfulReservations_sys_id-multi-entry}{#wsd_multi_reserv-POST-add__unSuccessfulReservations-multi-entry}{#wsd_multi_reserv-POST-add__unSuccessfulReservations_error-multi-entry}{#wsd_multi_reserv-POST-add__unSuccessfulReservations_inserted-multi-entry}{#wsd_multi_reserv-POST-add__unSuccessfulReservations_reservable-multi-entry}{#wsd_multi_reserv-POST-add__unSuccessfulReservations_success-multi-entry}{#wsd_multi_reserv-POST-add__unSuccessfulReservations_sy_id-multi-entry}

| Nom | Description |
|-|-|
| résultat | Renvoyer les résultats de la création ou de la mise à jour de plusieurs réservations. Type de données : objet "result": { "parent": "String", "success": Boolean, "successfulReservations": Array, "unSuccessfulReservations": Array } |
| résultat.parent | Sys_id de la réservation parente. Un parent peut avoir une ou plusieurs réservations enfants qui lui sont associées. Type de données : chaîne |
| résultat.succès | Marqueur indiquant si la réservation a été créée avec succès. Valeurs possibles : * true : créé avec succès. * false : échec de l'opération. Type de données : booléennes |
| résultat.reservationsréussies | Liste des réservations qui ont été créées avec succès. Type de données : tableau "successfulReservations": [ { "error": "String", "inserted": Boolean, "reservable": "String" "success": Boolean, "sys_id": "String" } ] |
| résultat.successfulreservations.error | Message d'erreur si un problème s'est produit lors de la création de la réservation. Type de données : chaîne |
| résultat.reservationsréussies.insérées | Marqueur indiquant si la réservation a été correctement insérée. Par exemple, lorsqu'une réservation est ajoutée. Valeurs possibles : * vrai : inséré avec succès. * false : échec de l'opération. Type de données : booléennes |
| résultat.reservationsréussies.réservable | Sys_id du lieu de travail pour lequel la réservation a été effectuée. Situé dans la table Emplacement du lieu de travail \[sn_wsd_core_workplace_location\]. Type de données : chaîne |
| résultat.succèsRéservations.succès | Marqueur indiquant si la réservation a été créée avec succès. Valeurs possibles : * true : créé avec succès. * false : échec de l'opération. Type de données : booléennes |
| result.successfulReservations.sys_id | Sys_id de la réservation qui a été créée. Situé dans la table Réservation du lieu de travail \[sn_wsd_rsv_reservation\]. Type de données : chaîne |
| résultat.unSuccessfulReservations | Liste des réservations qui ont échoué. Type de données : tableau "unSuccessfulReservations": [ { "error": "String", "inserted": Boolean, "reservable": "String" "success": Boolean, "sys_id": "String" } ] |
| résultat.unSuccessfulReservations.error | Message d'erreur si un problème s'est produit lors de la création de la réservation. Type de données : chaîne |
| résultat.unSuccessfulReservations.inséré | Marqueur indiquant si la réservation a été correctement insérée. Valeurs possibles : * vrai : inséré avec succès. * false : échec de l'opération. Type de données : booléennes |
| résultat.unSuccessfulReservations.reservable | Sys_id du lieu de travail pour lequel la réservation essayait d'être effectuée. Situé dans la table Emplacement du lieu de travail \[sn_wsd_core_workplace_location\]. Type de données : chaîne |
| résultat.unSuccessfulReservations.success | Marqueur indiquant si la réservation a été créée avec succès. Valeurs possibles : * true : créé avec succès. * false : échec de l'opération. Type de données : booléennes |
| result.unSuccessfulReservations.sys_id | Sys_id de la réservation qui a échoué. Toujours null. Type de données : chaîne |
[ ]

### Demande cURL

Cet exemple de code montre comment réserver deux lieux de travail différents pour la même réservation.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/add" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
        \"reservable_module\": \"c31241cedb7650106c731dcd13961917\",
        \"subject\": \"Test-123\",
        \"reservation_purpose\": \"meeting\",
        \"timezone\": \"US/Pacific\",
        \"requested_for\": \"6816f79cc0a8016401c5a33be04be441\",
        \"reservables\": [
            {
                \"sys_id\": \"fe1f744edb7650106c731dcd139619ca\",
                \"is_private\": false
            },
            {
                \"sys_id\": \"d1208d4edb7650106c731dcd1396194a\",
                \"is_private\": false
            }
        ],
        \"start\": \"2023-01-12T11:30:00Z\",
        \"end\": \"2023-01-12T12:30:00Z\",
        \"reservation_type\": \"space\"
    }" \
    --user "username":"password"

Résultats renvoyés :

    {
      "result": {
        "success": true,
        "parent": "08e8a18687586550cfaa99b73cbb354f",
        "successfulReservations": [
          {
            "success": true,
            "inserted": true,
            "sys_id": "44e8a18687586550cfaa99b73cbb3552",
            "error": null,
            "reservable": "fe1f744edb7650106c731dcd139619ca"
          },
          {
            "success": true,
            "inserted": true,
            "sys_id": "04e8a18687586550cfaa99b73cbb3555",
            "error": null,
            "reservable": "d1208d4edb7650106c731dcd1396194a"
          }
        ],
        "unSuccessfulReservations": []
      }
    }