API V2 réservable WSD

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 18 minutes de lecture
  • L’API Prestation de services de lieu de travail (WSD) Reservable V2 fournit des points de terminaison permettant de récupérer les détails d’un réservable, une entité qui peut être réservée, telle qu’un emplacement de lieu de travail, à partir d’une ServiceNow instance.

    L’API WSD Reservable V2 est une nouvelle version du API WSD réservable fichier . L’API WSD Reservable V2 récupère les détails de tous les espaces réservables sur le portail WSD que vous sélectionnez lors d’une réservation. La version originale de l’API WSD Reservable utilisait un appel GET, mais limitait le paramètre de chemin d’accès sys_ID à 35 caractères. La nouvelle version de l’API WSD Reservable V2 est un appel POST et prend toutes les sys_ids dans le corps de la demande pour éviter les limitations de caractères.

    Pour accéder à cette API, l’appelant doit avoir le rôle sn_wsd_core.workplace_user.

    Cette API s’exécute dans l’espace de noms sn_wsd_rsv . Pour accéder à cette API, le module d’extension Workplace Reservation Management (sn_wsd_rsv) doit être activé.

    Pour plus d’informations sur Gestion des réservations du lieu de travail, voir Gestion des réservations du lieu de travail.

    API WSD V2 réservable : POST /sn_wsd_rsv/v2/reservable/list_reservables

    Renvoie les détails d’un ou de plusieurs réservables spécifiés.

    Format d'URL

    URL par défaut : POST api/sn_wsd_rsv/v2/reservable/list_reservables

    Paramètres de demande pris en charge

    Tableau 1. Paramètres de chemin d'accès
    Nom Description
    api_version Requis. Version du point de terminaison auquel accéder. Spécifiez v2 pour utiliser cette API, sinon l’utilisation de v1 utilise la version par défaut de l’API WSD réservable.

    Type de données : chaîne

    Tableau 2. Paramètres de requête
    Nom Description
    Aucun
    Tableau 3. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    include_flexible_services Marqueur indiquant s’il faut renvoyer les services flexibles associés au réservable dans la réponse.

    Un service flexible est une disposition supplémentaire disponible avec un élément de lieu de travail réservable lorsqu’une réservation est effectuée. Par exemple, style salle de classe - Rangées de tables disposées avec tous les participants orientés vers l’avant de la salle. Pour plus d’informations sur les services flexibles, voir Créer un service flexible.

    Valeurs valides :
    • true : renvoie les informations sur le service flexible.
    • faux : ne renvoyez pas les informations de service flexible.

    Type de données : booléennes

    Valeur par défaut : false

    include_standard_services Marqueur indiquant s’il faut renvoyer les informations sur les services standard dans la réponse. Ces informations se trouvent dans la table Service standard [sn_wsd_rsv_standard_service].

    Un service standard décrit les dispositions de base disponibles avec un élément de lieu de travail réservable lorsque la réservation est effectuée, telles que les tableaux blancs, les moniteurs supplémentaires et les services similaires. Pour plus d’informations sur les services standard, voir Services standard.

    Valeurs valides :
    • true : renvoie les informations sur les services standard.
    • false : ne renvoie pas les informations de services standard.

    Type de données : booléennes

    Valeur par défaut : false

    include_reservable_purposes Facultatif. Marqueur indiquant s’il faut renvoyer l’objectif associé au réservable.
    Valeurs valides :
    • vrai : renvoie l’objectif du réservable.
    • false : Ne renvoyez pas l’objectif du réservable.

    Type de données : booléennes

    Valeur par défaut : false

    include_layouts Marqueur indiquant s’il faut renvoyer les informations de mise en page de l’emplacement dans la réponse.

    Les informations sur la disposition de l’emplacement comprennent des éléments tels que la capacité, la capacité maximale, la préparation et la durée de nettoyage.

    Valeurs valides :
    • true : renvoie les informations de mise en page de l’emplacement.
    • false : ne renvoie pas les informations de mise en page de l’emplacement.

    Type de données : booléennes

    Valeur par défaut : false

    Table : disposition de l’emplacement [sn_wsd_rsv_m2m_location_layout]

    reservable_module_sys_id Requis. Sys_id du module réservable, par exemple : bureau, salle de réunion, etc.

    Un module réservable regroupe des types similaires d’éléments du lieu de travail.

    Pour plus d’informations sur les modules réservables, voir Configurer un module réservable.

    Type de données : chaîne

    Valeur par défaut : valeur vide

    Table : module réservable [sn_wsd_rsv_reservable_module]

    reservation_start_time Heure de début de la réservation pour valider le délai des services supplémentaires.

    Format : format UTC, aaaa-MM-jj HH :mm :ss

    Type de données : chaîne

    space_sys_ids Requis. sys_ids séparées par des virgules des espaces sélectionnés.

    Type de données : chaîne

    Valeur par défaut : valeur vide

    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.

    Tableau 4. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json

    Type de contenu Format de données du corps de la réponse. Prend uniquement en charge application/json.
    Tableau 5. En-têtes de réponses
    En-tête Description
    Aucun

    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.

    Tableau 6. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été correctement traitée.
    404Impossible de trouver des réservables.

    Recherchez la table Espaces principaux WSD [sn_wsd_core_spaces] et vérifiez que l’enregistrement de l’espace est présent.

    500Une erreur s'est produite ! Impossible de récupérer les réservables.

    Il s’agit d’une erreur du serveur. Contactez l’administration système.

    Paramètres du corps de réponse

    Nom Description
    résultat Détails sur chaque réservable correspondant.

    Type de données : tableau d’objets

    {
      "result": [
        {
          "allow_invitees": Boolean,
          "area": {Object},
          "building": {Object},
          "campus": {Object},
          "capacity": Number,
          "description": "String",
          "display_number_of_attendees": Boolean,
          "display_on_behalf_of": Boolean,
          "display_sensitivity": Boolean,
          "email": "String",
          "employee_override_privacy": Boolean
          "enable_group_reservations": Boolean,
          "enable_reservation_privacy": Boolean,
          "external_id": "String",
          "flexible_services": [Array],
          "floor": {Object},
          "image": {Object},
          "is_reservable": Boolean,
          "layouts": [Array],
          "location_type": {Object},
          "meetingProviders": [Array],
          "moduleType": "String",
          "name": "String",
          "number": "String",
          "order": Number,
          "require_approval": Boolean,
          "requires_check_in": Boolean,
          "require_subject": Boolean,
          "reservable_quantity": Number,
          "site": {Object},
          "standard_services": [Array],
          "sys_id": "String",
          "title": "String",
          "type": "String",
          "tableName": "String"
        }
      ]
    }
    result.allow_invitees Marqueur indiquant si les employés sont en mesure d’ajouter des invités à la réservation.
    Valeurs valides :
    • vrai : autorise les employés à ajouter des invités à la réservation.
    • false : n’autorisez pas les employés à ajouter des invités à la réservation.

    Type de données : booléennes

    résultat.zone Zone où se trouve le réservable.

    Type de données : objet

    "area": {
       "display_value": "String",
       "sys_id": "String"
    }

    Tableau : Zone [sn_wsd_core_area]

    result.area.display_value Valeur d’affichage de la zone.

    Type de données : chaîne

    result.area.sys_id Sys_id de l’enregistrement de la zone associée.

    Type de données : chaîne

    résultat.bâtiment Bâtiment où se trouve le réservable.

    Type de données : objet

    "building": {
      "display_value": "String",
      "sys_id": "String",
      "timezone": {Object}
    }

    Table : Bâtiment [sn_wsd_core_building]

    result.building.display_value Valeur d’affichage pour le bâtiment.

    Type de données : chaîne

    result.building.sys_id Sys_id de l’enregistrement du bâtiment associé.

    Type de données : chaîne

    résultat.bâtiment.fuseau horaire Détails du fuseau horaire du bâtiment.

    Type de données : objet

    "timezone": {
      "displayValue": "String",
      "value": "String"
    }
    result.building.timezone.display_value Afficher la valeur du fuseau horaire dans lequel se trouve le bâtiment associé.

    Type de données : chaîne

    résultat.bâtiment.fuseauhoraire.valeur Valeur interne du fuseau horaire dans lequel se trouve le bâtiment associé.

    Type de données : chaîne

    résultat.campus Campus où se trouve le réservable.

    Type de données : objet

    "campus": {
      "display_value": "String",
      "sys_id": "String"
    }

    Table : Campus [sn_wsd_core_campus]

    result.campus.display_value Valeur d’affichage pour le campus.

    Type de données : chaîne

    result.campus.sys_id Sys_id de l’enregistrement du campus associé.

    Type de données : chaîne

    résultat.capacité Nombre de personnes que le réservable peut accueillir.

    Type de données : nombre

    résultat.description Description du réservable.

    Type de données : chaîne

    result.display_number_of_attendees Marqueur indiquant si les utilisateurs peuvent spécifier le nombre de participants dans la réservation.
    Valeurs valides :
    • vrai : les utilisateurs peuvent spécifier le nombre de participants.
    • faux : les utilisateurs ne peuvent pas spécifier le nombre d’affichages des participants.

    Type de données : booléennes

    result.display_on_behalf_of Marqueur indiquant si les réservations peuvent être effectuées au nom de quelqu’un d’autre.
    Valeurs valides :
    • vrai : au nom de ceux pris en charge.
    • false : au nom de non pris en charge.

    Type de données : booléennes

    result.display_sensitivity Marqueur qui indique si les utilisateurs peuvent définir la sensibilité de la réservation, par exemple normale ou privée.
    Valeurs valides :
    • vrai : capable de définir la sensibilité.
    • faux : impossible de définir la sensibilité. La valeur par défaut est normale.

    Type de données : booléennes

    result.email Adresse e-mail associée au réservable.

    Type de données : chaîne

    result.employee_override_privacy Marqueur indiquant si les utilisateurs peuvent remplacer le paramètre de confidentialité pour le réservable associé.

    Pour plus d’informations sur ces paramètres de confidentialité, consultez Paramètres de confidentialité de l’emplacement et impact.

    Valeurs valides :
    • vrai : les utilisateurs peuvent remplacer le paramètre de confidentialité pour le réservable associé.
    • faux : les utilisateurs ne peuvent pas remplacer le paramètre de confidentialité pour le réservable associé.
    result.enable_group_reservations Marqueur indiquant si les utilisateurs peuvent effectuer une réservation de groupe.
    Valeurs valides :
    • true : peut effectuer des réservations de groupe.
    • faux : Impossible d’effectuer des réservations de groupe.

    Type de données : booléennes

    result.enable_reservation_privacy

    Marqueur qui indique le paramètre par défaut pour la confidentialité de la réservation.

    Pour plus d’informations sur ces paramètres de confidentialité, reportez-vous à la section Location privacy settings and impact.

    Valeurs possibles :
    • true : les réservations sont privées par défaut.
    • false : les réservations ne sont pas privées par défaut.

    Type de données : booléennes

    result.external_id ID externe du réservable.

    Type de données : chaîne

    result.flexible_services Renseigné uniquement si le include_flexible_services paramètre est défini sur vrai et que le module d’extension de gestion des tickets du lieu de travail est installé. Description des services flexibles associés aux réservables. Il peut y avoir un service flexible parent et plusieurs services flexibles enfants.

    Type de données : tableau d’objets

    flexible_services": [
      {
        "additional_text": "String",
        "allow_only_single_service_item_selection": Boolean,
        "category": "String",
        "currency_code": "String",
        "flexible_service": [Array],
        "label": "String",
        "sub_category": "String",
        "sub_title": "String",
        "text": "String",
        "title": {Object}
      }
    ]

    Table : élément de service du lieu de travail [sn_wsd_case_workplace_service_item]

    result.flexible_services.texte_supplémentaire Texte qui invite l’utilisateur à sélectionner des services flexibles supplémentaires.

    Type de données : chaîne

    result.flexible_services.allow_only_single_service_item_selection Marqueur indiquant si les utilisateurs peuvent sélectionner un seul élément de service parmi le groupe de services flexibles au sein d’une réservation.
    Valeurs valides :
    • vrai : ne peut effectuer qu’une seule sélection.
    • faux : Peut effectuer plusieurs sélections.

    Type de données : booléennes

    result.flexible_services.catégorie Catégorie des services flexibles.

    Type de données : chaîne

    result.flexible_services.currency_code Code de devise utilisé pour calculer le montant de la devise lors de la commande de services flexibles.

    Type de données : chaîne

    result.flexible_services.service_flexible Services flexibles correspondant à un service flexible parent.

    Type de données : tableau d’objets

    "flexible_service": [
      {
        "flexible_service": [Array],
        "label": "String",
        "sub_category": "String"
     }
    ]

    Table : élément de service du lieu de travail [sn_wsd_case_workplace_service_item]

    result.flexible_services.service_flexible.flexible_service Détails de chaque service flexible correspondant à un service flexible parent.

    Type de données : tableau d’objets

    "flexible_service": [
      {
        "additional_text": "String",
        "capacity_enabled": Boolean,
        "category": "String",
        "category_label": "String",
        "cleanup_duration": "String",
        "image": "String",
        "max_capacity": Number,
        "name": "String",
        "preparation_duration": "String",
        "price_per_unit": {Object},
        "quantity_enabled": Boolean,
        "quantity_required": Boolean,
        "short_description": "String",
        "sub_category": "String",
        "sub_category_label": "String",
        "sub_title": "String",
        "sys_id": "String",
        "text": "String",
        "title": {Object}
      }
    ]
    result.flexible_services.service_flexible.flexible_service.additional_text Texte utilisé pour inviter un utilisateur à sélectionner des services flexibles supplémentaires.

    Type de données : chaîne

    result.flexible_services.service_flexible.flexible_service.capacity_enabled Marqueur indiquant si la capacité de la salle doit apparaître dans la réservation. Si cette valeur est définie sur vrai, quantity_enabled elle sera toujours fausse.
    Valeurs valides :
    • vrai : la capacité doit apparaître.
    • faux : la capacité ne doit pas apparaître.

    Type de données : booléennes

    result.flexible_services.service_flexible.flexible_service.catégorie Catégorie du service flexible.

    Type de données : chaîne

    result.flexible_services.service_flexible.flexible_service.étiquette_catégorie Étiquette de catégorie de service flexible.

    Type de données : chaîne

    result.flexible_services.service_flexible.flexible_service.durée_nettoyage Durée nécessaire pour nettoyer ou supprimer le service ajouté au réservable.

    Type de données : nombre

    Unité : millisecondes

    result.flexible_services.service_flexible.flexible_service.image Lien vers l’image du service flexible.

    Type de données : chaîne

    result.flexible_services.service_flexible.flexible_service.max_capacité Nombre maximum d’occupants que le réservable peut accueillir.

    Type de données : nombre

    result.flexible_services.service_flexible.flexible_service.nom Nom du service flexible.

    Type de données : chaîne

    result.flexible_services.service_flexible.flexible_service.preparation_duration Durée nécessaire pour ajouter le service au réservable.

    Type de données : chaîne

    Unité : millisecondes

    result.flexible_services.service_flexible.flexible_service.prix_par_unité Détails du coût d’ajout du service flexible au réservable.

    Type de données : objet

    "price_per_unit": {
      "code": "String",
      "value": "String"
    }
    result.flexible_services.service_flexible.flexible_service.prix_par_unité.code Code de devise à utiliser lors du calcul du coût, par exemple GBP ou USD.

    Type de données : chaîne

    result.flexible_services.service_flexible.flexible_service.prix_par_unité.valeur Coût pour chaque unité du service flexible dans la devise définie dans le paramètre de code.

    Type de données : chaîne

    result.flexible_services.service_flexible.flexible_service.quantity_enabled Marqueur indiquant si le champ quantité doit apparaître dans la réservation. Si cette valeur est définie sur vrai, capacity_enabled elle sera toujours fausse.
    Valeurs valides :
    • vrai : la quantité doit apparaître.
    • false : la quantité ne doit pas apparaître.

    Type de données : booléennes

    result.flexible_services.service_flexible.flexible_service.quantité_requise Marqueur indiquant si la quantité est requise.
    Valeurs valides :
    • true : la quantité est requise.
    • false : la quantité n’est pas requise.

    Type de données : booléennes

    result.flexible_services.service_flexible.flexible_service.description_courte

    Brève description du service flexible.

    Type de données : chaîne

    result.flexible_services.service_flexible.flexible_service.sous_catégorie Nom de sous-catégorie du service flexible, tel que chair_layout.

    Type de données : chaîne

    result.flexible_services.service_flexible.flexible_service.sous_étiquette_catégorie_ Étiquette de sous-catégorie du service flexible, telle que la disposition de la chaise.

    Type de données : chaîne

    result.flexible_services.service_flexible.flexible_service.sub_title Nom du sous-titre du service flexible enfant.

    Type de données : chaîne

    result.flexible_services.service_flexible.flexible_service.sys_id Sys_id de service flexible.

    Type de données : chaîne

    result.flexible_services.service_flexible.flexible_service.texte Texte utilisé pour inviter un utilisateur à sélectionner des services flexibles.

    Type de données : chaîne

    result.flexible_services.service_flexible.flexible_service.title Détails des titres à utiliser lors de l’ajout et de la modification du service flexible enfant dans l’interface utilisateur.

    Type de données : objet

    "title": {
      "add": "String",
      "edit": "String"
    }
    result.flexible_services.service_flexible.flexible_service.titre.ajouter Titre utilisé lors de l’ajout d’un service flexible enfant dans l’interface utilisateur.

    Type de données : chaîne

    result.flexible_services.service_flexible.flexible_service.titre.modifier Titre utilisé lors de la modification d’un service flexible enfant dans l’interface utilisateur.

    Type de données : chaîne

    result.flexible_services.étiquette_service_flexible Étiquette de service flexible.

    Type de données : chaîne

    result.flexible_services.service_flexible.sub_category Sous-catégorie des services flexibles parents, tels qu’une chaise supplémentaire.

    Type de données : chaîne

    result.flexible_services.service_flexible.sub_title Nom du sous-titre du service flexible parent.

    Type de données : chaîne

    result.flexible_services.service_flexible.texte Texte utilisé pour inviter un utilisateur à sélectionner un parent services flexibles.

    Type de données : chaîne

    result.flexible_services.service_flexible.title Détails des titres à utiliser lors de l’ajout et de la modification du service flexible parent dans l’interface utilisateur.

    Type de données : objet

    "title": {
      "add": "String",
      "edit": "String"
    }
    result.flexible_services.service_flexible.title.ajouter Titre utilisé lors de l’ajout d’un service parent flexible dans l’interface utilisateur.

    Type de données : chaîne

    result.flexible_services.service_flexible.title.éditer Titre utilisé lors de la modification d’un service parent flexible dans l’interface utilisateur.

    Type de données : chaîne

    résultat.étage Détails sur l’étage où se trouve le réservable.

    Type de données : objet

    "floor": {
      "display_value": "String",
      "sys_id": "String"
    }

    Table : Étage [sn_wsd_core_floor]

    result.floor.display_value Numéro d’affichage de l’étage où le réservable réside, par exemple 12.

    Type de données : chaîne

    result.floor.sys_id Sys_id de l’enregistrement associé.

    Type de données : chaîne

    Table : Étage [sn_wsd_core_floor]

    résultat.image Détails sur une image représentant le réservable associé.

    Type de données : objet

    "image": {
      "link": "String",
      "sys_id": "String"
    }

    Tableau : Images [db_image]

    result.image.link Lien vers une image représentant le réservable.

    Type de données : chaîne

    result.image.sys_id Sys_id de l’enregistrement d’image associé.

    Type de données : chaîne

    Tableau : Images [db_image]

    result.is_reservable Marqueur indiquant si le service flexible peut être réservé.
    Valeurs valides :
    • true : un service flexible peut être réservé.
    • false : le service flexible ne peut pas être réservé.

    Type de données : booléennes

    résultats.mises en page Renseigné uniquement si le include_layouts paramètre est défini sur vrai.

    Liste des mises en page associées au réservable.

    Type de données : tableau d’objets

    "layouts": [
      {
        "capacity": Number,
        "cleanup_duration": "String",
        "image": {Object},
        "is_default": Boolean,
        "max_capacity": Number,
        "name": "String",
        "preparation_duration": "String",
        "short_description": "String",
        "sys_id": "String"
      }
    ]
    résultat.dispositions.capacité Nombre de personnes qui participeront à la réunion.

    Type de données : nombre

    result.layouts.cleanup_duration Durée nécessaire pour nettoyer le réservable pour cette mise en page.

    Type de données : nombre

    Unité : millisecondes

    résultat.dispositions.image Détails sur une image qui représente la mise en page du réservable associé.

    Type de données : objet

    "image": {
      "link": "String",
      "sys_id": "String"
    }

    Tableau : Images [db_image]

    result.layouts.image.link Lien vers une image qui représente la mise en page de ce réservable.

    Type de données : chaîne

    Tableau : Images [db_image]

    result.layouts.image.sys_id Sys_id de l’enregistrement d’image associé.

    Type de données : chaîne

    result.layouts.is_default Marqueur indiquant si la mise en page associée est celle par défaut pour le réservable.
    Valeurs valides :
    • true : valeur par défaut.
    • false : ce n’est pas la valeur par défaut.

    Type de données : booléennes

    result.layouts.max_capacité Nombre maximal de personnes que la mise en page associée au réservable peut accueillir.

    Type de données : nombre

    result.layouts.name Nom de la disposition de l’emplacement.

    Type de données : chaîne

    result.layouts.preparation_duration Durée nécessaire à la préparation de la mise en page d’emplacement associée.

    Type de données : nombre

    Unité : millisecondes

    result.layouts.short_description Brève description de la disposition de l’emplacement.

    Type de données : chaîne

    result.layouts.sys_id Sys_id de la disposition de l’emplacement.

    Type de données : chaîne

    Table : Mise en page [sn_wsd_rsv_layout]

    result.location_type Détails sur le type d’emplacement du réservable, tel que lieu de travail/bureau, café ou salle de sport.

    Type de données : objet

    "location_type": {
      "display_value": "String",
      "sys_id": "String"
    }

    Table : Type d’espace [sn_wsd_core_space_type]

    result.location_type.valeur_affichage Valeur d’affichage du type d’emplacement.

    Type de données : chaîne

    result.location_type.sys_id Sys_id de l’enregistrement associé.

    Type de données : chaîne

    Table : Type d’espace [sn_wsd_core_space_type]

    result.meetingProviders Détails sur les fournisseurs de réunion virtuelle associés au réservable.

    Type de données : tableau d’objets

    "meetingProviders": [
      {
        "display_value": "String",
        "value": "String"
      }
    ]

    Table : Fournisseur de réunion virtuelle [sn_wsd_rsv_virtual_meeting_provider]

    result.meetingProviders.display_value Valeur d’affichage du nom du fournisseur virtuel.

    Type de données : chaîne

    résultat.réunionfournisseurs.valeur Valeur réelle du nom du fournisseur virtuel dans l’enregistrement.

    Type de données : chaîne

    résultat.moduleType Module réservable associé au réservable, tel que bureaux ou salle de réunion.

    Type de données : chaîne

    result.name Nom du réservable.

    Type de données : chaîne

    nombre.résultat Identificateur unique du réservable. Cette valeur est plus lisible par l’homme que la sys_id.

    Type de données : chaîne

    résultat.ordre Numéro de commande du réservable.

    Type de données : nombre

    result.require_approval Marqueur indiquant si la réservation du réservable nécessite une approbation.
    Valeurs possibles :
    • vrai : approbation requise.
    • faux : l’approbation n’est pas requise.

    Type de données : booléennes

    result.requires_check_in Marqueur indiquant si le réservable nécessite que l’utilisateur s’enregistre.
    Valeurs valides :
    • vrai : enregistrement obligatoire.
    • faux : l’enregistrement n’est pas obligatoire.

    Type de données : booléennes

    result.require_subject Marqueur qui indique si l’utilisateur doit saisir un objet lors de la réservation.
    Valeurs valides :
    • true : objet requis.
    • false : l’objet n’est pas obligatoire.

    Type de données : booléennes

    result.reservable_quantity Nombre maximal de fois où le réservable associé peut être réservé pour la même durée. Cette valeur est utilisée lors de l’affectation d’espaces de quartier à une zone.

    Type de données : nombre entier

    result.site Détails sur le site où se trouve le réservable.

    Type de données : objet

    "site": {
      "display_value": "String",
      "sys_id": "String"
    }

    Table : Site [sn_wsd_core_site]

    result.site.display_value Valeur d’affichage du site.

    Type de données : chaîne

    result.standard_services Renseigné uniquement si le include_standard_services paramètre est défini sur vrai.
    Services standards associés, tels que tableau à feuilles mobiles, écran de projection, tableau blanc et marqueurs.

    Type de données : tableau d’objets

    "standard_services": [
      {
        "font_awesome_icon": "String",
        "name": "String",
        "short_description": "String",
        "sys_id": "String"
      }
    ]
    result.standard_services.font_awesome_icon Nom de l’icône de miniature associée au service standard.

    Type de données : chaîne

    result.standard_services.name Nom du service standard.

    Type de données : chaîne

    result.standard_services.description_courte Brève description du service standard.

    Type de données : chaîne

    result.standard_services.sys_id Sys_id de l’enregistrement de service standard.

    Type de données : chaîne

    Table : Service standard [sn_wsd_rsv_standard_service]

    result.site.sys_id Sys_id de l’enregistrement de site associé.

    Type de données : chaîne

    Table : Site [sn_wsd_core_site]

    result.tableName Nom de la table dans laquelle se trouve l’enregistrement réservable.

    Type de données : chaîne

    résultat.titre Titre du réservable.

    Type de données : chaîne

    type.résultat Type d’un réservable, tel que l’emplacement.

    Type de données : chaîne

    Demande cURL

    L’exemple de code suivant montre comment appeler ce point de terminaison pour renvoyer des détails sur les réservables spécifiés.

    curl "http://instance.servicenow.com/api/sn_wsd_rsv/v2/reservable/list_reservables" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{\"space_sys_ids\":\"3ed3139977220110b3d7be377b5a99d1\",\"reservable_module_sys_id\":\"c31241cedb7650106c731dcd13961917\",\"include_flexible_services\":true,\"include_standard_services\":true,\"include_reservable_purposes\":true,\"include_layouts\":false}" \
    --user 'username:'password'
    

    Corps de la réponse. Cet exemple renvoie des détails sur tous les réservables répertoriés dans le corps de la demande.

    {
      "result": [
        {
          "sys_id": "3ed3139977220110b3d7be377b5a99d1",
          "external_id": "447b9dfb475a011064062782846d4382",
          "wsd_email": null,
          "name": "A263",
          "title": "A263",
          "description": null,
          "image": null,
          "number": "ROOM0000181",
          "site": {
            "sys_id": "b35f47ffdba05010f342a0da4b961998",
            "display_value": "Italy"
          },
          "campus": {
            "sys_id": "87831b1977220110b3d7be377b5a9946",
            "display_value": ""
          },
          "building": {
            "sys_id": "dea39b1977220110b3d7be377b5a9955",
            "display_value": "",
            "timezone": {
              "value": "",
              "displayValue": ""
            }
          },
          "floor": {
            "sys_id": "68d31f5977220110b3d7be377b5a991b",
            "display_value": ""
          },
          "area": null,
          "capacity": "17",
          "reservable_quantity": "1",
          "location_type": {
            "sys_id": "20713b83eb512010b89bfdfc9c522899",
            "display_value": "Room"
          },
          "order": null,
          "requires_check_in": null,
          "is_reservable": "1",
          "type": "location",
          "moduleType": "Meeting rooms",
          "meetingProviders": [],
          "require_subject": true,
          "allow_invitees": false,
          "display_number_of_attendees": false,
          "display_on_behalf_of": true,
          "display_sensitivity": true,
          "enable_group_reservations": false,
          "allow_reservation_message": false,
          "warn_employee_for_duplicate_reservation": false,
          "enable_reservation_privacy": false,
          "employee_override_privacy": false,
          "tableName": "sn_wsd_core_room",
          "require_approval": false,
          "flexible_services": [
            {
              "allow_only_single_service_item_selection": true,
              "category": "50723fbf07100110c9b36b6e0ad300b4",
              "label": "Space arrangement",
              "description": "This is a service to request a different space configuration as part of a reservation.",
              "sub_category": "chair_layout",
              "title": {
                "edit": "Update Space arrangement for A263",
                "add": "Add Space arrangement for A263"
              },
              "sub_title": "Add a space arrangement item to get started",
              "text": "Select space arrangement item",
              "additional_text": "Select another space arrangement item",
              "currency_code": "GBP",
              "flexible_service": [
                {
                  "sub_category": "chair_layout",
                  "label": "Chair layout",
                  "flexible_service": [
                    {
                      "sys_id": "e2ecf7b307500110c9b36b6e0ad30033",
                      "name": "Classroom Style",
                      "short_description": "Rows of tables arranged with all participants facing towards the front of the room",
                      "category": "50723fbf07100110c9b36b6e0ad300b4",
                      "category_label": "Space arrangement",
                      "sub_category": "chair_layout",
                      "sub_category_label": "Chair layout",
                      "image": "08d6ff68d5122110fa9b1500c1d696c5.iix",
                      "quantity_enabled": false,
                      "quantity_required": false,
                      "capacity_enabled": true,
                      "max_capacity": "",
                      "preparation_duration": "1970-01-01 00:15:00",
                      "cleanup_duration": "1970-01-01 00:15:00",
                      "price_per_unit": {
                        "value": 0,
                        "code": "GBP"
                      },
                      "title": {
                        "edit": "Update Space arrangement for A263",
                        "add": "Add Space arrangement for A263"
                      },
                      "sub_title": "Add a space arrangement item to get started",
                      "text": "Select space arrangement item",
                      "additional_text": "Select another space arrangement item"
                    },
                    {
                      "sys_id": "1cf33fff07100110c9b36b6e0ad30077",
                      "name": "Banquet Rounds",
                      "short_description": "Round tables arranged throughout the room. Participants are seated around the entire perimeter of each table",
                      "category": "50723fbf07100110c9b36b6e0ad300b4",
                      "category_label": "Space arrangement",
                      "sub_category": "chair_layout",
                      "sub_category_label": "Chair layout",
                      "image": "cdc67720d5522110fa9b1500c1d69636.iix",
                      "quantity_enabled": false,
                      "quantity_required": false,
                      "capacity_enabled": true,
                      "max_capacity": "",
                      "preparation_duration": "1970-01-01 00:15:00",
                      "cleanup_duration": "1970-01-01 00:15:00",
                      "price_per_unit": {
                        "value": 0,
                        "code": "GBP"
                      },
                      "title": {
                        "edit": "Update Space arrangement for A263",
                        "add": "Add Space arrangement for A263"
                      },
                      "sub_title": "Add a space arrangement item to get started",
                      "text": "Select space arrangement item",
                      "additional_text": "Select another space arrangement item"
                    },
                    {
                      "sys_id": "21e2c08407600110c9b36b6e0ad3007c",
                      "name": "Theater Style",
                      "short_description": "Rows of chairs (no tables) arranged with all participants facing towards the front of the room",
                      "category": "50723fbf07100110c9b36b6e0ad300b4",
                      "category_label": "Space arrangement",
                      "sub_category": "chair_layout",
                      "sub_category_label": "Chair layout",
                      "image": "f3d67fa4d5122110fa9b1500c1d6968b.iix",
                      "quantity_enabled": false,
                      "quantity_required": false,
                      "capacity_enabled": true,
                      "max_capacity": "",
                      "preparation_duration": "1970-01-01 00:15:00",
                      "cleanup_duration": "1970-01-01 00:15:00",
                      "price_per_unit": {
                        "value": 0,
                        "code": "GBP"
                      },
                      "title": {
                        "edit": "Update Space arrangement for A263",
                        "add": "Add Space arrangement for A263"
                      },
                      "sub_title": "Add a space arrangement item to get started",
                      "text": "Select space arrangement item",
                      "additional_text": "Select another space arrangement item"
                    }
                  ]
                }
              ]
            },
            {
              "allow_only_single_service_item_selection": false,
              "category": "c9ab1c89c3500110547e3810a840dd41",
              "label": "Catering",
              "description": "This is a service to request catering as part of a reservation.",
              "sub_category": "drinks",
              "title": {
                "edit": "Update Catering for A263",
                "add": "Add Catering for A263"
              },
              "sub_title": "Add a catering item to get started",
              "text": "Select catering item",
              "additional_text": "Select another catering item",
              "currency_code": "GBP",
              "flexible_service": [
                {
                  "sub_category": "drinks",
                  "label": "Drinks",
                  "flexible_service": [
                    {
                      "sys_id": "48d72985c3900110547e3810a840dd7d",
                      "name": "Champagne",
                      "short_description": "",
                      "category": "c9ab1c89c3500110547e3810a840dd41",
                      "category_label": "Catering",
                      "sub_category": "drinks",
                      "sub_category_label": "Drinks",
                      "image": "",
                      "quantity_enabled": true,
                      "quantity_required": false,
                      "capacity_enabled": false,
                      "max_capacity": "",
                      "preparation_duration": 0,
                      "cleanup_duration": 0,
                      "price_per_unit": {
                        "value": 0,
                        "code": "GBP"
                      },
                      "title": {
                        "edit": "Update Catering for A263",
                        "add": "Add Catering for A263"
                      },
                      "sub_title": "Add a catering item to get started",
                      "text": "Select catering item",
                      "additional_text": "Select another catering item"
                    }
                  ]
                }
              ]
            }
          ],
          "standard_services": [],
          "reservable_purposes": []
        }
      ]
    }