API des invités de réservation WSD

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 11 minutes de lecture

    • L’API Prestation de services de lieu de travailBooking Guestes (WSD) fournit des points de terminaison permettant d’ajouter des invités à des réservations, d’extraire les invités d’une réservation et de réaffecter les invités d’une réservation.

    Pour accéder à cette API, l’appelant doit disposer du rôle sn_wsd_core.workplace_user et le module d’extension Workplace Reservation Management (sn_wsd_rsv) doit être activé.

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

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

    Invités de la réservation WSD : GET /api/sn_wsd_rsv/wsd_reservation_invitees/reservation/{sys_id}

    Récupère des détails sur les invités associés à une réservation spécifiée.

    Format d'URL

    URL avec version : /api/sn_wsd_rsv/{api_version}/wsd_reservation_invitees/reservation/{sys_id}

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

    Remarque :
    Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST scriptées, des informations supplémentaires sur la version se trouvent dans le formulaire Service REST scripté.

    Paramètres de demande pris en charge

    Tableau 1. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison autre que la plus récente.

    Type de données : chaîne
    sys_id Sys_id de la réservation pour laquelle renvoyer les détails de l’invité.

    Type de données : chaîne
    Tableau 2. Paramètres de requête
    Nom Description
    Néant
    Tableau 3. Paramètres du corps de la demande
    Nom Description
    Néant

    En-têtes

    Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP 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
    Tableau 5. En-têtes de réponses
    En-tête Description
    Néant

    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é traitée avec succès.
    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.

    Paramètres du corps de réponse

    Nom Description
    résultat Renvoyer des résultats pour les invités associés à la réservation spécifiée.

    Type de données : objet

    {
  "result": {
    "invitees": [Array],
    "reservationId": "String",
    "reservationSubType": "String",
    "success": Boolean
  }
}
    résultat.invités Détails sur les invités associés à la réservation.

    Type de données : tableau d’objets

    "invitees": [
  {
    "email": "String",
    "firstName": "String",
    "inviteeId": "String",
    "inviteState": {Object},
    "inviteeType": "String",
    "isVIP": Boolean,
    "isWifiRequired": Boolean,
    "isParkingRequired": Boolean,
    "lastName": "String",
    "licensePlate": "String",
    "location": {Object},
    "name": "String",
    "org": "String",
    "parkingType": "String",
    "phoneNumber": "String",
    "privateNotes": "String",
    "reservationId": "String",
    "reservationInviteeId": "String",
    "title": "String",
    "visitorType": "String"
  }
]
    result.invitees.email
    Adresse e-mail de l’invité.

    Type de données : chaîne
    résultat.invités.prénom Prénom de l’invité.

    Type de données : chaîne
    résultat.invités.inviteeId
    Sys_id de l’enregistrement utilisateur de l’employé.

    Type de données : chaîne

    Table : Utilisateur [sys_user]
    résultat.invités.inviteÉtat Détails sur l’état actuel de l’invité pour la réservation.

    Type de données : objet

    "inviteState": {
  "displayValue": "String",
  "value": "String"
}
    résultat.invités.inviteÉtat.valeurd’affichage Valeur d’affichage de l’état de l’invité, telle que Nouveau ou Supprimé.

    Type de données : chaîne
    résultat.invités.inviteÉtat.valeur Valeur interne pour l’état de l’invité.

    Type de données : chaîne
    résultat.invités.typeinvité
    Type d’invité.
    Valeurs valides : (sensible à la casse)
    • employé
    • visiteur

    Type de données : chaîne
    résultat.invités.isVIP Marqueur indiquant si l’invité est classifié comme VIP.
    Valeurs valides :
    • vrai : l’invité est un VIP.
    • faux : l’invité n’est pas un VIP.

    Type de données : booléennes
    résultat.invités.isWifiRequired Marqueur indiquant si le mot de passe WIFI doit être fourni au visiteur à l’entrée.
    Valeurs valides :
    • vrai : fournir un mot de passe WIFI.
    • faux : ne fournissez pas de mot de passe WIFI.

    Type de données : booléennes
    résultat.invités.estParkingObligatoire Marqueur indiquant si l’invité a besoin d’un parking.
    Valeurs valides :
    • vrai : Stationnement nécessaire.
    • faux : Le stationnement n’est pas nécessaire.

    Type de données : booléennes
    résultat.invités.nom de famille Nom de famille de l’invité.

    Type de données : chaîne
    résultat.invités.plaque d’immatriculation Plaque d’immatriculation de l’invité.

    Type de données : chaîne
    résultat.invités.emplacement Détails sur l’emplacement du lieu de travail de l’invité.

    Type de données : objet

     "location": {
  "displayName": "String",
  "sysId": "String"
}
    result.invitees.location.displayName Nom d’affichage de l’emplacement du lieu de travail de l’invité, par exemple Dublin.

    Type de données : chaîne
    result.invitees.location.sysId Sys_id de l’emplacement du lieu de travail de l’invité.

    Type de données : chaîne

    Table : emplacement du lieu de travail [sn_wsd_core_worplace_location]
    result.invitees.name Nom de l’invité.

    Type de données : chaîne
    result.invitees.org Organisation de l’invité.

    Type de données : chaîne
    résultat.invités.parkingType Type de stationnement requis pour l’invité.
    Valeurs valides : (sensible à la casse)
    • ev_parking
    • aucun
    • normal_parking
    • van_accessible_parking

    Type de données : chaîne
    résultat.invités.numérotéléphone Numéro de téléphone de l’invité.

    Type de données : chaîne
    résultat.invités.privéesNotes Toutes les notes supplémentaires fournies par l’invité.

    Type de données : chaîne
    résultat.invites.reservationId Sys_id de la réservation à laquelle l’invité est associé.

    Type de données : chaîne

    Table : Réservation du lieu de travail [sn_wsd_rsv_reservation]
    résultat.invités.reservationInviteeId

    Sys_id de l’invité de la réservation pour le visiteur.

    Type de données : chaîne

    Table : Invité de la réservation [sn_wsd_rsv_m2m_reservation_invitee]
    résultat.invités.titre Titre de l’invité.

    Type de données : chaîne
    résultat.invités.typedevisiteur Type d’invité.
    Valeurs valides : (sensible à la casse)
    • Client d’entreprise
    • contractant
    • friend_family
    • others

    Type de données : chaîne
    résultat.reservationId Sys_id de la réservation à laquelle l’invité est associé.

    Type de données : chaîne

    Table : Réservation du lieu de travail [sn_wsd_rsv_reservation]
    résultat.reservationSubType Sous-type de l’enregistrement de réservation, tel que mono-enfant ou multi-enfant.

    Type de données : chaîne
    Résultat.Réussite Marqueur indiquant si l’appel a réussi.
    Valeurs possibles :
    • vrai : l’appel du point de terminaison a réussi.
    • faux : échec de l’appel du point de terminaison.

    Type de données : booléennes

    Demande cURL

    L’exemple de code suivant montre comment récupérer les invités pour une réservation.

    curl 
"http://instance.servicenow.com/api/sn_wsd_rsv/wsd_reservation_invitees/reservation/17979dc9536b01103cf7ddeeff7b12b3" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Renvoyer les résultats :

    {
  "result": {
    "success": true,
    "reservationId": "17979dc9536b01103cf7ddeeff7b12b3",
    "reservationSubType": "single",
    "invitees": [
      {
        "reservationId": "17979dc9536b01103cf7ddeeff7b12b3",
        "location": {
          "sysId": "19efb84edb7650106c731dcd1396193c",
          "displayName": "Dublin"
        },
        "reservationInviteeId": "1f97d58d53e701103cf7ddeeff7b129a",
        "inviteeType": "employee",
        "inviteState": {
          "displayValue": "New",
          "value": "new"
        },
        "inviteeId": "6816f79cc0a8016401c5a33be04be441",
        "name": "System Administrator",
        "email": "admin@example.com"
      },
      {
        "reservationId": "17979dc9536b01103cf7ddeeff7b12b3",
        "location": {
          "sysId": "19efb84edb7650106c731dcd1396193c",
          "displayName": "Dublin"
        },
        "reservationInviteeId": "8ee7ddc9536b01103cf7ddeeff7b1219",
        "inviteeType": "employee",
        "inviteState": {
          "displayValue": "New",
          "value": "new"
        },
        "inviteeId": "62826bf03710200044e0bfc8bcbe5df1",
        "name": "Abel Tuter",
        "email": "abel.tuter@example.com"
      },
      {
        "reservationId": "17979dc9536b01103cf7ddeeff7b12b3",
        "location": {
          "sysId": "19efb84edb7650106c731dcd1396193c",
          "displayName": "Dublin"
        },
        "reservationInviteeId": "4ae7d10d536b01103cf7ddeeff7b126b",
        "inviteeType": "visitor",
        "inviteState": {
          "displayValue": "New",
          "value": "new"
        },
        "inviteeId": "86e7d10d536b01103cf7ddeeff7b1267",
        "firstName": "Visitor",
        "lastName": "User",
        "name": "Visitor User",
        "email": "visitoruser@example.com",
        "phoneNumber": "+919876543210",
        "isVIP": true,
        "parkingType": "normal_parking",
        "licensePlate": "1234",
        "isParkingRequired": true,
        "org": "Senow",
        "visitorType": "contractor",
        "title": "President",
        "isWifiRequired": true,
        "privateNotes": "Visiting"
      }
    ]
  }
}

    Invités de réservation WSD : POST /api/sn_wsd_rsv/wsd_reservation_invitees/reassign

    Réaffecte les invités spécifiés d’une réservation à une autre.

    Format d'URL

    URL avec version : /api/sn_wsd_rsv/{api_version}/wsd_reservation_invitees/reassign

    URL par défaut : /api/sn_wsd_rsv/wsd_reservation_invitees/reassign

    Remarque :
    Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST scriptées, des informations supplémentaires sur la version se trouvent dans le formulaire Service REST scripté.

    Paramètres de demande pris en charge

    Tableau 7. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison autre que la plus récente.

    Type de données : chaîne
    Tableau 8. Paramètres de requête
    Nom Description
    Néant
    Tableau 9. Paramètres du corps de la demande
    Nom Description
    ID de réservation Requis. Sys_id de la réservation pour laquelle réaffecter les invités.

    Type de données : chaîne

    Table : Réservation du lieu de travail [sn_wsd_rsv_reservation]
    reservationInvités Liste des invités à réaffecter à la réservation identifiée dans le reservationId paramètre.

    Cela supprime les invités spécifiés d’une réservation antérieure dans laquelle ils étaient présents selon la table des invités de la réservation et les déplace vers cette réservation.

    Type de données : tableau de chaînes

    Table : Invité de la réservation [sn_wsd_rsv_m2m_reservation_invitee]

    En-têtes

    Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP 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 10. En-têtes de demandes
    En-tête Description
    Accepter Format des données du corps de la demande. Types pris en charge : application/json, application/xml ou, text/xml.

    Valeur par défaut : application/json
    Type de contenu Format des données du corps de la demande. Prend uniquement en charge application/json.
    Tableau 11. En-têtes de réponses
    En-tête Description
    Néant

    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 12. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été traitée avec succès.
    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.

    Paramètres du corps de réponse

    Nom Description
    résultat Détails sur la réaffectation de l’invité.

    Type de données : objet

    "result": {
   "reservationInviteeIds": [Array],
   "success": Boolean
}
    résultat.reservationInviteeIds Liste des sys_ids des invités de la réservation qui ont été réaffectés à la réservation spécifiée.

    Type de données : tableau de chaînes
    Résultat.Réussite Marqueur indiquant si les invités ont été réaffectés à la réservation.
    Valeurs possibles :
    • vrai : les invités ont été réaffectés avec succès.
    • faux : les invités n’ont pas été réaffectés.

    Type de données : booléennes

    Demande cURL

    L’exemple de code suivant montre comment réaffecter des invités à une réservation.

    curl "http://instance.servicenow.com/api/sn_wsd_rsv/wsd_reservation_invitees/reassign" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"reservationId\":\"3984e6c1532f01103cf7ddeeff7b129b\",
\"reservationInvitees\":{\"aa31427f531701103cf7ddeeff7b1243\",\"e231427f531701103cf7ddeeff7b1243\"}
}" \
--user 'username':'password'

    Renvoyer les résultats :

    {
  "result": {
    "success": true,
    "reservationInviteeIds": [
      "aa31427f531701103cf7ddeeff7b1243",
      "e231427f531701103cf7ddeeff7b1243"
    ]
  }
}

    Invités de la réservation WSD : POST /api/sn_wsd_rsv/wsd_reservation_invitees/submit

    Ajoute les invités spécifiés à une réservation spécifiée.

    Format d'URL

    URL avec version : /api/sn_wsd_rsv/{api_version}/wsd_reservation_invitees/submit

    URL par défaut : /api/sn_wsd_rsv/wsd_reservation_invitees/submit

    Remarque :
    Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST scriptées, des informations supplémentaires sur la version se trouvent dans le formulaire Service REST scripté.

    Paramètres de demande pris en charge

    Tableau 13. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison autre que la plus récente.

    Type de données : chaîne
    Tableau 14. Paramètres de requête
    Nom Description
    Néant
    Tableau 15. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    invités Liste des invités à ajouter à la réservation spécifiée.

    Type de données : objet

    "invitees": [
  {
    "email": "String",
    "firstName": "String",
    "inviteeId": "String",
    "inviteeType": "String",
    "isVIP": Boolean,
    "isWifiRequired": Boolean,
    "lastName": "String",
    "licensePlate": "String",
    "org": "String",
    "parkingType": "String",
    "phone": "String",
    "privateNotes": "String",
    "title": "String",
    "visitorType": "String"
  }
]
    invitees.email Requis lorsque inviteeType est « visiteur ».
    Adresse e-mail de l’invité.

    Type de données : chaîne
    invités.prénom Prénom de l’invité.

    Type de données : chaîne
    invitees.inviteeId Requis si inviteType est « employé ».
    Sys_id de l’enregistrement utilisateur de l’employé.

    Type de données : chaîne

    Table : Utilisateur [sys_user]
    invités.typed’invité Requis.
    Type d’invité.
    Valeurs valides : (sensible à la casse)
    • employé
    • visiteur

    Type de données : chaîne
    invités.isVIP Marqueur indiquant si l’invité est classifié comme VIP.
    Valeurs valides :
    • vrai : l’invité est un VIP.
    • faux : l’invité n’est pas un VIP.

    Type de données : booléennes
    invités.isWifiRequired Marqueur indiquant si le mot de passe WIFI doit être fourni au visiteur à l’entrée.
    Valeurs valides :
    • vrai : fournir un mot de passe WIFI.
    • faux : ne fournissez pas de mot de passe WIFI.

    Type de données : booléennes
    invités.nom.invités Nom de famille de l’invité.

    Type de données : chaîne
    invités.plaque d’immatriculation Plaque d’immatriculation de l’invité.

    Type de données : chaîne
    invitees.org Organisation de l’invité.

    Type de données : chaîne
    invités.parkingType Type de stationnement requis pour l’invité.
    Valeurs valides : (sensible à la casse)
    • ev_parking
    • aucun
    • normal_parking
    • van_accessible_parking

    Type de données : chaîne
    invités.téléphone Numéro de téléphone de l’invité.

    Type de données : chaîne
    invités.privéesNotes Toutes les notes supplémentaires fournies par l’invité.

    Type de données : chaîne
    invités.titre Titre de l’invité.

    Type de données : chaîne
    invités.visitorType Type d’invité.
    Valeurs valides : (sensible à la casse)
    • Client d’entreprise
    • contractant
    • friend_family
    • others

    Type de données : chaîne
    ID de réservation Requis.
    Sys_id de la réservation à laquelle ajouter les invités.

    Type de données : chaîne

    Table : Réservations du lieu de travail [sn_wsd_rsv_reservation]

    En-têtes

    Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP 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 16. En-têtes de demandes
    En-tête Description
    Accepter Format des données du corps de la demande. Types pris en charge : application/json, application/xml ou, text/xml.

    Valeur par défaut : application/json
    Type de contenu Format des données du corps de la demande. Prend uniquement en charge application/json.
    Tableau 17. En-têtes de réponses
    En-tête Description
    Néant

    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 18. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été traitée avec succès.
    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.

    Paramètres du corps de réponse

    Nom Description
    résultat Résultat de l’ajout des invités à la réservation.

    Type de données : objet

    "result": {
  "reservationId": "String",
  "success": Boolean
}
    résultat.reservationId Sys_id de la réservation à laquelle l’invité a été ajouté.

    Type de données : chaîne
    Résultat.Réussite Marqueur indiquant si les invités ont été ajoutés à la réservation.
    Valeurs possibles :
    • vrai : les invités ont été ajoutés avec succès.
    • false : les invités n’ont pas été ajoutés.

    Type de données : booléennes

    Demande cURL

    L’exemple de code suivant montre comment ajouter à la fois un visiteur et un employé à une réservation.

    curl "http://instance.servicenow.com/api/sn_wsd_rsv/v1/wsd_reservation_invitees/submit" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{[
  \"reservationId\": \"041c4a13532f01103cf7ddeeff7b12c0\",
  \"invitees\": [
  {
    \"inviteeType\": \"employee\",
    \"inviteeId\": \"62826bf03710200044e0bfc8bcbe5df1\"
  },
  {
    \"inviteeType\":  \"visitor\",
    \"email\": \"visitoruser@example.com\",
    \"firstName\": \"Visitor\",
    \"lastName\":\"User\",
    \"isVIP\":true,
    \"visitorType\":\"contractor\",
    \"title\": \"ServiceNow Developer\",
    \"phone\": \"+91 9876543210\",
    \"isWifiRequired\": true,
    \"parkingType\": \"ev_parking\",
    \"licensePlate\": \"TS00TS0000\",
    \"org\": \"ServiceNow\",
    \"privateNotes\": \"Remarks\"
  }
]}" \
--user 'username':'password'

    Renvoyer les résultats :

    {
  "result": {
    "success": true,
    "reservationId": "17979dc9536b01103cf7ddeeff7b12b3"
  }
}