API de présence WSD

  • Rversion finale: Australia
  • Mis à jour 27 avr. 2026
  • 38 minutes de lecture

    • L’API de présence WSD permet aux utilisateurs de gérer leur calendrier de présence au bureau, y compris les routines hebdomadaires, les exceptions ponctuelles et la visibilité des collaborateurs.

    Cette API prend en charge l’expérience de conciergerie Prestation de services de lieu de travail (WSD) en permettant aux employés de communiquer à leurs collègues leur présence prévue au bureau. Utilisez cette API pour les actions suivantes :
    • Récupérez les données de présence complètes d’un utilisateur authentifié, y compris sa routine hebdomadaire au bureau, les exceptions planifiées et éventuellement les informations de présence des collaborateurs.
    • Gérez les routines hebdomadaires au bureau afin que les employés puissent définir un horaire récurrent.
    • Créez et gérez des exceptions ponctuelles qui remplacent la routine d’une date spécifique.
    • Affichez et gérez les collaborateurs pour permettre une planification coordonnée au bureau.

    Un utilisateur authentifié est une personne qui est connectée ou dont les informations d’identification sont incluses dans la demande d’API. Points de terminaison d’appel dans n’importe quel ordre ; chacun fonctionne indépendamment.

    L’API de présence WSD appartient à l’espace de noms sn_wsd_concierge. Le point de terminaison API de réservation WSD GET /user/context peut renvoyer les données de calendrier de présence de l’API de présence WSD lorsque le module d’extension de concierge est actif.

    Besoins

    L’API de présence WSD nécessite :
    • Le rôle sn_wsd_core.workplace_user affecté à l’utilisateur.
    • Le module d’extension Prestation de services de lieu de travail Core (com.sn_wsd_core) activé.
    • Au moins un enregistrement utilisateur doit exister dans sys_user avec le rôle sn_wsd_core.workplace_user affecté.

    Présence WSD : SUPPRIMER /api/sn_wsd_concierge/v1/presence/collaborator/{collaborator_id}

    Supprime un collaborateur de la liste de visibilité de présence de l’utilisateur authentifié. Utilisez ce point de terminaison lorsqu’un utilisateur ne souhaite plus suivre la présence d’un collègue au bureau.

    Un utilisateur authentifié est une personne qui est connectée ou dont les informations d’identification sont incluses dans la demande d’API. Le collaborateur est identifié par son sys_id.

    Format d'URL

    URL versionnée : /api/sn_wsd_concierge/{api_version}/presence/collaborator/{collaborator_id}

    URL par défaut : /api/sn_wsd_concierge/presence/collaborator/{collaborator_id}

    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
    collaborator_id Sys_id du collaborateur à supprimer de la liste de visibilité de l’utilisateur.

    Table : Utilisateur [sys_user]

    Type de données : chaîne
    Tableau 2. Paramètres de requête
    Nom Description
    Néant
    Tableau 3. Paramètres de corps de demande (XML ou JSON)
    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, application/xmlou text/xml.
    Autorisation Informations d’identification d’authentification. Prend en charge l’authentification de base ou l’authentification basée sur la session.
    Tableau 5. En-têtes de réponses
    En-tête Description
    Type de contenu Format des données du corps de la réponse : application/json.

    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.
    400Demande incorrecte. Paramètre de chemin d’accès collaborator_id manquant ou non valide.
    404 Introuvable. Le collaborateur spécifié 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 la réponse (JSON ou XML)

    Nom Description
    résultat Objet contenant les résultats de la demande.

    Type de données : objet

    "result": {
  "message": "String"
}
    résultat.message Message de confirmation indiquant le nombre de collaborateurs supprimés.

    Type de données : chaîne

    Demande cURL

    Cet exemple supprime un collaborateur spécifique de la liste de visibilité de présence de l’utilisateur authentifié.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/collaborator/usr1a2b3c4d5e6" \
--request DELETE \
--header "Accept: application/json" \
--user "username:password"

    Corps de la réponse.

    {
  "result": {
    "message": "1 collaborator(s) removed"
  }
}

    Présence WSD : SUPPRIMER /api/sn_wsd_concierge/v1/presence/exception/{exception_id}

    Supprime une exception de présence spécifique identifiée par son sys_id. Utilisez ce point de terminaison lorsqu’un utilisateur souhaite supprimer un remplacement ponctuel et revenir à sa routine hebdomadaire habituelle pour cette date.

    Format d'URL

    URL versionnée : /api/sn_wsd_concierge/{api_version}/presence/exception/{exception_id}

    URL par défaut : /api/sn_wsd_concierge/presence/exception/{exception_id}

    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
    exception_id Requis. Sys_id de l’exception de présence à supprimer.

    Table : Exceptions relatives à la présence des employés (sn_wsd_concierge_employee_presence_exception)

    Type de données : chaîne
    Tableau 8. Paramètres de requête
    Nom Description
    Néant
    Tableau 9. Paramètres de corps de demande (XML ou JSON)
    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 10. 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, application/xmlou text/xml.
    AutorisationInformations d’identification d’authentification. Prend en charge l’authentification de base ou l’authentification basée sur la session.
    Tableau 11. En-têtes de réponses
    En-tête Description
    Type de contenu Format des données du corps de la réponse : application/json.

    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.
    400 Demande incorrecte. Paramètre de chemin d’accès exception_id manquant ou non valide.
    404 Introuvable. L’exception spécifiée 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 la réponse (JSON ou XML)

    Nom Description
    résultat Objet contenant les résultats de la demande.

    Type de données : objet

    "result": {
  "message": "String"
}
    résultat.message Message de confirmation indiquant que l’exception a été supprimée.

    Type de données : chaîne

    Demande cURL

    Cet exemple supprime l’exception exc1a2b3c4d5e6, en rétablissant cette date à la routine hebdomadaire normale de l’utilisateur.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/exception/exc1a2b3c4d5e6" \
--request DELETE \
--header "Accept: application/json" \
--user "username:password"

    Corps de la réponse.

    {
  "result": {
    "message": "Exception deleted successfully"
  }
}

    Présence WSD : GET /api/sn_wsd_concierge/v1/presence/collaborator

    Récupère la liste des collaborateurs de l’utilisateur authentifié ainsi que les données de présence, la routine et les exceptions de chaque collaborateur. Utilisez ce point de terminaison pour afficher les calendriers de présence au bureau de vos collègues, ce qui permet une planification coordonnée au bureau.

    Format d'URL

    URL versionnée : /api/sn_wsd_concierge/{api_version}/presence/collaborator

    URL par défaut : /api/sn_wsd_concierge/presence/collaborator

    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
    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 16. 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, application/xmlou text/xml.
    Autorisation Informations d’identification d’authentification. Prend en charge l’authentification de base ou l’authentification basée sur la session.
    Tableau 17. En-têtes de réponses
    En-tête Description
    Type de contenu Format des données du corps de la réponse : application/json.

    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.
    404 Introuvable. L’utilisateur 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 la réponse (JSON ou XML)

    Nom Description
    résultat Objet contenant les résultats de la demande.

    Type de données : objet

    "result": {
  "count": Number,
  "collaborators": [Array]
}
    nombre.résultat Nombre total de collaborateurs renvoyés.

    Type de données : nombre
    résultat.collaborateurs Liste des collaborateurs avec leurs données de présence.

    Si la confidentialité est activée pour un collaborateur, privacy_enabled est vrai avec null routine et vide exceptions.

    Type de données : tableau d’objets

    "collaborators": [
 {
  "sys_id": "String", 
  "name": "String", 
  "privacy_enabled": Boolean,
  "routine": {Object},
  "exceptions": [Array]
 }
]
    result.collaborators.sys_id Sys_id de l’enregistrement utilisateur du collaborateur.

    Table : Utilisateur [sys_user]

    Type de données : chaîne
    result.collaborators.name Nom d’affichage du collaborateur tel qu’il figure dans son enregistrement de sys_user.

    Table : Utilisateur [sys_user]

    Type de données : chaîne
    result.collaborators.privacy_enabled Booléen. Marqueur indiquant si le collaborateur a activé la confidentialité sur ses données de présence.
    Valeurs valides :
    • vrai : la routine et les exceptions du collaborateur sont masquées. routine sera null et exceptions sera un tableau vide.
    • faux : les données de présence du collaborateur sont visibles.

    Type de données : booléennes
    résultat.collaborateurs.routine Routine hebdomadaire au bureau du collaborateur.

    Contient un marqueur booléen pour chaque jour de la semaine indiquant la présence prévue au bureau. Affiche vrai lorsque le collaborateur prévoit d’être au bureau ce jour-là et faux lorsque la présence n’est pas planifiée.

    Type de données : objet

    "routine": { 
   "monday": "Boolean", 
   "tuesday": "Boolean", 
   "wednesday": "Boolean", 
   "thursday": "Boolean", 
   "friday": "Boolean", 
   "saturday": "Boolean", 
   "sunday": "Boolean" 
}
    résultat.collaborateurs.exceptions Exceptions de présence ponctuelle du collaborateur. Renvoie un tableau vide si privacy_enabled est vrai.

    Type de données : tableau d’objets

    "exceptions": [ 
 { 
  "sys_id": "String", 
  "date": "String", 
  "in_office": "Boolean", 
  "origin": "String", 
  "location": "String" 
 } 
]
    result.collaborators.exceptions.sys_id Sys_id de l’enregistrement d’exception.

    Table : Exceptions relatives à la présence des employés (sn_wsd_concierge_employee_presence_exception)

    Type de données : chaîne
    result.collaborators.exceptions.date Date à laquelle cette exception s’applique. Il s’agit de la date à laquelle la routine de l’utilisateur est remplacée.

    Format : aaaa-MM-jj

    Type de données : chaîne
    result.collaborators.exceptions.in_office Marqueur indiquant si l’utilisateur sera au bureau à cette date. Cela remplace tout ce que la routine hebdomadaire spécifie pour ce jour de la semaine.
    Valeurs valides :
    • vrai : l’utilisateur sera au bureau.
    • faux : l’utilisateur ne sera pas au bureau

    Type de données : chaîne
    résultat.collaborateurs.exceptions.origine Source qui a créé l’exception.
    Valeurs valides :
    • user : créé manuellement par l’employé.
    • system : créé automatiquement par la plateforme.
    • manuel : créé par un administrateur ou au nom de l’utilisateur.

    Type de données : chaîne
    résultat.collaborateurs.exceptions.emplacement Nom ou identificateur du bureau où l’utilisateur se trouvera à cette date. Pertinent uniquement lorsque in_office est vrai. Peut être une chaîne vide lorsque l’utilisateur est distant.

    Type de données : chaîne

    Demande cURL

    Cet exemple récupère toutes les données de collaboration et de présence de l’utilisateur authentifié.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/collaborator" \
--request GET \
--header "Accept: application/json" \
--user "username:password"

    Corps de la réponse.

    {
  "result": {
    "count": 2,
    "collaborators": [
      {
        "sys_id": "usr1a2b3c4d5e6", "name": "Jane Smith", "privacy_enabled": false,
        "routine": {
          "monday": true, "tuesday": true, "wednesday": false,
          "thursday": true, "friday": false, "saturday": false, "sunday": false
        },
        "exceptions": [
          { "sys_id": "exc1a2b3c", "date": "2026-03-10", "in_office": true, "origin": "user", "location": "Building B" }
        ]
      },
      { "sys_id": "usr7f8g9h0i1j2", "name": "John Doe", "privacy_enabled": true, "routine": null, "exceptions": [] }
    ]
  }
}

    Présence WSD : GET /api/sn_wsd_concierge/v1/présence/exception

    Récupère les exceptions de présence pour l’utilisateur authentifié. Les exceptions peuvent être filtrées par une plage de dates ou par un sys_id d’exception spécifique. Utilisez ce point de terminaison lorsque vous avez besoin d’afficher les remplacements ponctuels de la routine hebdomadaire d’un utilisateur.

    Format d'URL

    URL versionnée : /api/sn_wsd_concierge/{api_version}/presence/exception

    URL par défaut : /api/sn_wsd_concierge/presence/exception

    Paramètres de demande pris en charge

    Tableau 19. 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 20. Paramètres de requête
    Nom Description
    exception_id Sys_id d’une exception spécifique à récupérer.

    Lorsqu’il est fourni, il remplace le filtre de plage de dates et renvoie uniquement l’exception correspondante.

    Table : Exceptions relatives à la présence des employés (sn_wsd_concierge_employee_presence_exception)

    Type de données : chaîne
    exception_start_date Date de début pour le filtrage des exceptions.

    Format : aaaa-MM-jj

    Type de données : chaîne

    Par défaut : Aujourd’hui
    exception_end_date Date de fin du filtrage des exceptions.

    Format : aaaa-MM-jj

    Type de données : chaîne

    Par défaut : Aujourd’hui +3 mois
    Tableau 21. Paramètres de corps de demande (XML ou JSON)
    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 22. 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, application/xmlou text/xml.
    Autorisation Informations d’identification d’authentification. Prend en charge l’authentification de base ou l’authentification basée sur la session.
    Tableau 23. En-têtes de réponses
    En-tête Description
    Type de contenu Format des données du corps de la réponse : application/json.

    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 24. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été traitée avec succès.
    400 Demande incorrecte. Format de date non valide pour exception_start_date ou exception_end_date.
    404 Introuvable. L’exception spécifiée 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 la réponse (JSON ou XML)

    Nom Description
    résultat Objet contenant les résultats de la demande.

    Type de données : objet

    "result": {
  "exceptions": [Array]
}
    Résultat.Exceptions Liste des exceptions de présence correspondant aux critères de filtre.

    Type de données : tableau d’objets

    "exceptions": [
{
  "sys_id": "sys_id", 
  "date": "String", 
  "in_office": String, 
  "origin": "String", 
  "location": "String" 
 }
]
    result.exceptions.date Date à laquelle cette exception s’applique. Il s’agit de la date à laquelle la routine de l’utilisateur est remplacée.

    Format : format aaaa-MM-jj

    Type de données : chaîne
    result.exceptions.in_office Marqueur indiquant si l’utilisateur sera au bureau à cette date. Cela remplace tout ce que la routine hebdomadaire spécifie pour ce jour de la semaine.
    Valeurs valides :
    • vrai : l’utilisateur sera au bureau.
    • faux : l’utilisateur ne sera pas au bureau

    Type de données : chaîne
    résultat.exceptions.emplacement Nom ou identificateur de l’emplacement du bureau où l’utilisateur se trouvera à cette date. Pertinent uniquement lorsque in_office est vrai. Peut être une chaîne vide lorsque l’utilisateur est distant.

    Type de données : chaîne
    résultat.exceptions.origine Source qui a créé l’exception.
    Valeurs valides :
    • user : créé manuellement par l’employé.
    • system : créé automatiquement par la plateforme.
    • manuel : créé par un administrateur ou au nom de l’utilisateur.

    Type de données : chaîne
    result.exceptions.sys_id Sys_id de l’enregistrement d’exception.

    Table : Exceptions relatives à la présence des employés (sn_wsd_concierge_employee_presence_exception)

    Type de données : chaîne

    Demande cURL

    Cet exemple récupère toutes les exceptions pour le premier semestre 2026.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/exception?exception_start_date=2026-01-01&exception_end_date=2026-06-30" \
--request GET \
--header "Accept: application/json" \
--user "username:password"

    Corps de la réponse.

    {
  "result": {
    "exceptions": [
      { "sys_id": "exc1a2b3c4d5e6", "date": "2026-02-14", "in_office": true, "origin": "user", "location": "Building A" },
      { "sys_id": "exc7f8g9h0i1j2", "date": "2026-03-17", "in_office": false, "origin": "system", "location": "" }
    ]
  }
}

    Présence WSD : GET /api/sn_wsd_concierge/v1/presence

    Récupère les données de présence complètes de l’utilisateur authentifié, y compris sa routine hebdomadaire au bureau, les exceptions de présence programmées et éventuellement les informations de présence de ses collaborateurs.

    Utilisez ce point de terminaison pour obtenir une vue globale de la présence prévue au bureau d’un utilisateur. Vous pouvez également interroger les données de présence d’un autre utilisateur en fournissant ses sys_id, sous réserve des paramètres de confidentialité.

    Format d'URL

    URL versionnée : /api/sn_wsd_concierge/{api_version}/presence

    URL par défaut : /api/sn_wsd_concierge/presence

    Paramètres de demande pris en charge

    Tableau 25. 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 26. Paramètres de requête
    Nom Description
    user_id Sys_id de l’utilisateur cible dont les données de présence doivent être récupérées. Si elle n’est pas fournie, renvoie les données de présence de l’utilisateur authentifié.
    Remarque :
    Les requêtes inter-utilisateurs renvoient 401 Non autorisé sauf si l’appelant dispose d’une autorisation explicite.

    Table : Utilisateur [sys_user]

    Type de données : chaîne
    exception_start_date Date de début pour filtrer les exceptions de présence.

    Format : aaaa-MM-jj

    Type de données : chaîne

    Par défaut : Aujourd’hui
    exception_end_date Date de fin pour filtrer les exceptions de présence.

    Format : aaaa-MM-jj

    Type de données : chaîne

    Par défaut : Aujourd’hui + 3 mois
    inclure Données connexes à inclure dans la réponse.

    Seule valeur valide : collaborateurs

    Type de données : chaîne
    Tableau 27. Paramètres de corps de demande (XML ou JSON)
    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 28. 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, application/xmlou text/xml.
    Autorisation Informations d’identification d’authentification. Prend en charge l’authentification de base ou l’authentification basée sur la session.
    Tableau 29. En-têtes de réponses
    En-tête Description
    Type de contenu Format des données du corps de la réponse : application/json.

    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 30. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été traitée avec succès.
    400 Demande incorrecte. Format de date non valide pour exception_start_date ou exception_end_date, ou format de user_id non valide.
    401 Non autorisé. L’utilisateur authentifié n’a pas l’autorisation d’afficher les données de présence de l’utilisateur cible. Renvoyé lorsque user_id est fourni et ne correspond pas à l’utilisateur authentifié.
    404 Introuvable. L’utilisateur spécifié est introuvable.
    500 Erreur interne du serveur. Une erreur inattendue s’est produite lors du traitement de la demande.

    Paramètres du corps de la réponse (JSON ou XML)

    Nom Description
    résultat Objet contenant les résultats de la réponse.
    "result": {
  "routine": {Object},
  "exceptions": [Array],
  "collaborators": [Array]
}
    résultat.routine Routine hebdomadaire au bureau pour l’utilisateur.

    Contient un marqueur booléen pour chaque jour de la semaine indiquant la présence prévue au bureau. Affiche la valeur vrai lorsque l’utilisateur authentifié prévoit d’être au bureau ce jour-là et la valeur faux lorsque la participation n’est pas planifiée.

    Type de données : objet

    "routine": { 
   "monday": "Boolean", 
   "tuesday": "Boolean", 
   "wednesday": "Boolean", 
   "thursday": "Boolean", 
   "friday": "Boolean", 
   "saturday": "Boolean", 
   "sunday": "Boolean" 
}
    Résultat.Exceptions Liste des exceptions de présence ponctuelle qui remplacent la routine de l’utilisateur pour des dates spécifiques.

    Type de données : tableau d’objets

    "exceptions": [ 
   { 
     "sys_id": "String", 
     "date": "String", 
     "in_office": "Boolean", 
     "origin": "String", 
     "location": "String" 
   } 
]
    result.exceptions.sys_id Sys_id de l’enregistrement d’exception.

    Table : Exceptions relatives à la présence des employés (sn_wsd_concierge_employee_presence_exception)

    Type de données : chaîne
    result.exceptions.date Date à laquelle s’applique cette exception, au format aaaa-MM-jj. Il s’agit de la date à laquelle la routine de l’utilisateur est remplacée.

    Type de données : chaîne
    result.exceptions.in_office Marqueur indiquant si l’utilisateur sera au bureau à cette date. Cela remplace tout ce que la routine hebdomadaire spécifie pour ce jour de la semaine.
    Valeurs valides :
    • vrai : l’utilisateur sera au bureau.
    • faux : l’utilisateur ne sera pas au bureau

    Type de données : chaîne
    résultat.exceptions.origine Source qui a créé l’exception.
    Valeurs valides :
    • user : créé manuellement par l’employé.
    • system : créé automatiquement par la plateforme.
    • manuel : créé par un administrateur ou au nom de l’utilisateur.

    Type de données : chaîne
    résultat.exceptions.emplacement Nom ou identificateur de l’emplacement du bureau où l’utilisateur se trouvera à cette date. Pertinent uniquement lorsque in_office est vrai. Peut être une chaîne vide lorsque l’utilisateur est distant.

    Type de données : chaîne
    résultat.collaborateurs Liste des collaborateurs et de leurs données de présence. Uniquement renvoyé lorsque include=collaborators est spécifié.

    Si la confidentialité est activée pour un collaborateur, privacy_enabled est vrai avec null routine et vide exceptions.

    Type de données : tableau d’objets

    "collaborators": [ 
   { 
     "sys_id": "String", 
     "name": "String", 
     "privacy_enabled": Boolean, 
     "routine": {Object}, 
     "exceptions": [Array]
   } 
]
    result.collaborators.sys_id Sys_id de l’enregistrement utilisateur du collaborateur.

    Table : Utilisateur [sys_user]

    Type de données : chaîne
    result.collaborators.name Le nom d’affichage du collaborateur tel qu’il figure dans son enregistrement de sys_user.

    Table : Utilisateur [sys_user]

    Type de données : chaîne
    result.collaborators.privacy_enabled Booléen. Marqueur indiquant si le collaborateur a activé la confidentialité sur ses données de présence.
    Valeurs valides :
    • vrai : la routine et les exceptions du collaborateur sont masquées. routine sera null et exceptions sera un tableau vide.
    • faux : les données de présence du collaborateur sont visibles.

    Type de données : booléennes
    résultat.collaborateurs.routine La routine hebdomadaire du collaborateur au bureau.

    Contient un marqueur booléen pour chaque jour de la semaine indiquant la présence prévue au bureau. Affiche vrai lorsque le collaborateur prévoit d’être au bureau ce jour-là et faux lorsque la présence n’est pas planifiée.

    Type de données : objet

    "routine": { 
   "monday": "Boolean", 
   "tuesday": "Boolean", 
   "wednesday": "Boolean", 
   "thursday": "Boolean", 
   "friday": "Boolean", 
   "saturday": "Boolean", 
   "sunday": "Boolean" 
}
    résultat.collaborateurs.exceptions Exceptions de présence ponctuelle du collaborateur. Suit la même structure que le paramètre de l’utilisateur exceptions authentifié. Renvoie un tableau vide si privacy_enabled est vrai.

    Type de données : tableau d’objets

    "exceptions": [ 
   { 
     "sys_id": "String", 
     "date": "String", 
     "in_office": "Boolean", 
     "origin": "String", 
     "location": "String" 
   } 
]

    Demande cURL

    Cet exemple récupère les données de présence complète de l’utilisateur authentifié, y compris les calendriers des collaborateurs, pour les exceptions du 1er trimestre 2026.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence?include=collaborators&exception_start_date=2026-01-01&exception_end_date=2026-03-31" \
--request GET \
--header "Accept: application/json" \
--user "username:password"

    Corps de la réponse.

    {
  "result": {
    "routine": {
      "monday": true,  "tuesday": false, "wednesday": true,
      "thursday": true, "friday": false, "saturday": false, "sunday": false
    },
    "exceptions": [
      {
        "sys_id": "a1b2c3d4e5f6",
        "date": "2026-02-14",
        "in_office": true,
        "origin": "user",
        "location": "Building A"
      }
    ],
    "collaborators": [
      {
        "sys_id": "f6e5d4c3b2a1",
        "name": "Jane Smith",
        "privacy_enabled": false,
        "routine": {
          "monday": true, "tuesday": true, "wednesday": false,
          "thursday": true, "friday": false, "saturday": false, "sunday": false
        },
        "exceptions": []
      }
    ]
  }
}

    Présence WSD : GET /api/sn_wsd_concierge/v1/présence/routine

    Récupère uniquement la routine hebdomadaire au bureau de l’utilisateur authentifié. Il s’agit d’une alternative légère à GET /presence lorsque vous n’avez besoin que du calendrier de routine sans exceptions ni collaborateurs.

    Format d'URL

    URL versionnée : /api/sn_wsd_concierge/{api_version}/presence/routine

    URL par défaut : /api/sn_wsd_concierge/presence/routine

    Paramètres de demande pris en charge

    Tableau 31. 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 32. Paramètres de requête
    Nom Description
    Néant
    Tableau 33. Paramètres de corps de demande (XML ou JSON)
    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 34. 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, application/xmlou text/xml.
    Autorisation Informations d’identification d’authentification. Prend en charge l’authentification de base ou l’authentification basée sur la session.
    Tableau 35. En-têtes de réponses
    En-tête Description
    Type de contenu Format des données du corps de la réponse : application/json.

    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 36. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été traitée avec succès.
    404Introuvable. L’utilisateur ou la routine 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 la réponse (JSON ou XML)

    Nom Description
    résultat Objet contenant les résultats de la demande.

    Type de données : objet

    "result": {
  "user_id": "String",
  "routine": {Object}
}
    result.user_id Sys_id de l’utilisateur dont la routine est renvoyée.

    Table : utilisateur [sys_id]

    Type de données : chaîne
    résultat.routine Calendrier récurrent au bureau hebdomadaire de l’utilisateur.

    Contient un marqueur booléen pour chaque jour de la semaine indiquant la présence prévue au bureau. Affiche vrai lorsque l’utilisateur prévoit d’être au bureau ce jour-là et faux lorsque la présence n’est pas planifiée.

    Type de données : objet

    "routine": {
  "monday": Boolean,
  "tuesday": Boolean,
  "wednesday": Boolean,
  "thursday": Boolean, 
  "friday": Boolean,
  "saturday": Boolean,
  "sunday": Boolean
}

    Demande cURL

    Cet exemple récupère la routine hebdomadaire au bureau de l’utilisateur authentifié.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/routine" \
--request GET \
--header "Accept: application/json" \
--user "username:password"

    Corps de la réponse. Indique que la routine de l’utilisateur affiche la présence au bureau du lundi au jeudi.

    {
  "result": {
    "user_id": "a1b2c3d4e5f6g7h8",
    "routine": {
      "monday": true,  "tuesday": true,  "wednesday": true,
      "thursday": true, "friday": false, "saturday": false, "sunday": false
    }
  }
}

    Présence WSD : PATCH /API/sn_wsd_concierge/v1/présence/routine

    Met à jour partiellement la routine hebdomadaire au bureau de l’utilisateur authentifié. Utilisez ce point de terminaison lorsqu’un utilisateur doit ajuster des jours spécifiques sans réinitialiser l’ensemble du calendrier.

    Seuls les jours indiqués dans le corps de la demande sont mis à jour. Tous les autres jours restent inchangés.

    Format d'URL

    URL versionnée : /api/sn_wsd_concierge/{api_version}/presence/routine

    URL par défaut : /api/sn_wsd_concierge/presence/routine

    Paramètres de demande pris en charge

    Tableau 37. 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 38. Paramètres de requête
    Nom Description
    Néant
    Tableau 39. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    routine Requis. Routine hebdomadaire de l’utilisateur authentifié.

    Contient un marqueur booléen pour chaque jour de la semaine indiquant la présence prévue au bureau. Affiche la valeur vrai lorsque l’utilisateur authentifié prévoit d’être au bureau ce jour-là et la valeur faux lorsque la participation n’est pas planifiée.

    Les jours omis dans la demande restent inchangés. Un objet de routine vide est accepté en tant que no-op.

    Type de données : objet

    "routine": { 
   "monday": "Boolean", 
   "tuesday": "Boolean", 
   "wednesday": "Boolean", 
   "thursday": "Boolean", 
   "friday": "Boolean", 
   "saturday": "Boolean", 
   "sunday": "Boolean" 
}

    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 40. 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, application/xmlou text/xml.
    Autorisation Informations d’identification d’authentification. Prend en charge l’authentification de base ou l’authentification basée sur la session.
    Type de contenu Format des données du corps de la demande : application/json.
    Tableau 41. En-têtes de réponses
    En-tête Description
    Type de contenu Format des données du corps de la réponse : application/json.

    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 42. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été traitée avec succès.
    400 Demande incorrecte. Corps de demande manquant, format non valide ou aucun champ de jour valide fourni.
    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 la réponse (JSON ou XML)

    Nom Description
    résultat Objet contenant les résultats de la demande.

    Type de données : objet

    "result": {
 "message": "String",
 "result": {Object}
}
    résultat.message Message de confirmation indiquant que la routine a été mise à jour.

    Type de données : chaîne
    résultat.résultat Contient l’objet de routine complet mis à jour avec les sept jours, y compris les jours inchangés.

    Type de données : objet

    "result": { 
  "routine": {Object} 
}
    résultat.routine Routine hebdomadaire au bureau. Contient un marqueur booléen pour chaque jour de la semaine où vrai indique la présence au bureau et faux indique aucune présence.

    Type de données : objet

    "routine": { 
  "monday": "Boolean", 
  "tuesday": "Boolean",
  "wednesday": "Boolean", 
  "thursday": "Boolean",
  "friday": "Boolean", 
  "saturday": "Boolean", 
  "sunday": "Boolean"
}

    Demande cURL

    Cet exemple met à jour uniquement le vendredi et le samedi sur vrai, ce qui laisse tous les autres jours inchangés.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/routine" \
--request PATCH \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--user "username:password" \
--data '{
  "routine": { "friday": true, "saturday": true }
}'

    Corps de la réponse.

    {
  "result": {
    "message": "Routine updated successfully",
    "result": {
      "routine": {
        "monday": true, "tuesday": true, "wednesday": true,
        "thursday": true, "friday": true, "saturday": true, "sunday": false
      }
    }
  }
}

    Présence WSD : POST /api/sn_wsd_concierge/v1/presence/collaborator

    Ajoute un ou plusieurs collaborateurs à la liste de visibilité de présence de l’utilisateur authentifié. Les collaborateurs peuvent alors afficher les données de présence des uns et des autres. Utilisez ce point de terminaison pour constituer une équipe ou un groupe de collègues dont vous souhaitez suivre la présence au bureau.

    Format d'URL

    URL versionnée : /api/sn_wsd_concierge/{api_version}/presence/collaborator

    URL par défaut : /api/sn_wsd_concierge/presence/collaborator

    Paramètres de demande pris en charge

    Tableau 43. 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 44. Paramètres de requête
    Nom Description
    Néant
    Tableau 45. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    collaborator_ids Requis. Tableau non vide de valeurs de sys_id identifiant les utilisateurs à ajouter en tant que collaborateurs.

    Table : Utilisateur [sys_user]

    Type de données : tableau de chaînes
    "collaborator_ids": ["String", "String"]

    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 46. 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, application/xmlou text/xml.
    Autorisation Informations d’identification d’authentification. Prend en charge l’authentification de base ou l’authentification basée sur la session.
    Type de contenu Format des données du corps de la demande : application/json.
    Tableau 47. En-têtes de réponses
    En-tête Description
    Type de contenu Format des données du corps de la réponse : application/json.

    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 48. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été traitée avec succès.
    400 Demande incorrecte. collaborator_ids manquante, tableau vide ou format de sys_id non valide.
    404 Introuvable. Une ou plusieurs sys_ids de collaborateurs n’ont pas été trouvées dans la table sys_user.
    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 la réponse (JSON ou XML)

    Nom Description
    résultat Objet contenant les résultats de la demande.

    Type de données : objet

    result": {
  "message": "String",
  "collaborators": [Array]
}
    résultat.message Message de confirmation indiquant que des collaborateurs ont été ajoutés.

    Type de données : chaîne
    résultat.collaborateurs Liste des collaborateurs nouvellement ajoutés avec leurs données de présence.

    Type de données : tableau d’objets

    "collaborators": [
 {
  "sys_id": "String",
  "name": "String",
  "privacy_enabled": Boolean,
  "routine": {Object},
  "exceptions": [Array]
 }
]
    result.collaborators.sys_id Sys_id de l’enregistrement utilisateur du collaborateur.

    Table : Utilisateur [sys_user]

    Type de données : chaîne
    result.collaborators.name Le nom d’affichage du collaborateur tel qu’il figure dans son enregistrement de sys_user.

    Table : Utilisateur [sys_user]

    Type de données : chaîne
    result.collaborators.privacy_enabled Booléen. Marqueur indiquant si le collaborateur a activé la confidentialité sur ses données de présence.
    Valeurs valides :
    • vrai : la routine et les exceptions du collaborateur sont masquées. routine sera null et exceptions sera un tableau vide.
    • faux : les données de présence du collaborateur sont visibles.

    Type de données : booléennes
    résultat.collaborateurs.routine La routine hebdomadaire du collaborateur au bureau.

    Contient un marqueur booléen pour chaque jour de la semaine indiquant la présence prévue au bureau. Affiche vrai lorsque le collaborateur prévoit d’être au bureau ce jour-là et faux lorsque la présence n’est pas planifiée.

    Type de données : objet

    "routine": { 
   "monday": "Boolean", 
   "tuesday": "Boolean", 
   "wednesday": "Boolean", 
   "thursday": "Boolean", 
   "friday": "Boolean", 
   "saturday": "Boolean", 
   "sunday": "Boolean" 
}
    résultat.collaborateurs.exceptions Exceptions de présence ponctuelle du collaborateur. Renvoie un tableau vide si privacy_enabled est vrai.

    Type de données : tableau d’objets

    "exceptions": [ 
   { 
     "sys_id": "String", 
     "date": "String", 
     "in_office": "Boolean", 
     "origin": "String", 
     "location": "String" 
   } 
]
    result.collaborators.exceptions.sys_id Sys_id de l’enregistrement d’exception.

    Table : Exceptions relatives à la présence des employés (sn_wsd_concierge_employee_presence_exception)

    Type de données : chaîne
    result.collaborators.exceptions.date Date à laquelle cette exception s’applique. Il s’agit de la date à laquelle la routine de l’utilisateur est remplacée.

    Format : format aaaa-MM-jj

    Type de données : chaîne
    result.collaborators.exceptions.in_office Marqueur indiquant si l’utilisateur sera au bureau à cette date. Cela remplace tout ce que la routine hebdomadaire spécifie pour ce jour de la semaine.
    Valeurs valides :
    • vrai : l’utilisateur sera au bureau.
    • faux : l’utilisateur ne sera pas au bureau

    Type de données : chaîne
    résultat.collaborateurs.exceptions.origine Source qui a créé l’exception.
    Valeurs valides :
    • user : créé manuellement par l’employé.
    • system : créé automatiquement par la plateforme.
    • manuel : créé par un administrateur ou au nom de l’utilisateur.

    Type de données : chaîne
    résultat.collaborateurs.exceptions.emplacement Nom ou identificateur de l’emplacement du bureau où l’utilisateur se trouvera à cette date. Pertinent uniquement lorsque in_office est vrai. Peut être une chaîne vide lorsque l’utilisateur est distant.

    Type de données : chaîne

    Demande cURL

    Cet exemple ajoute deux utilisateurs en tant que collaborateurs en fournissant leurs sys_ids.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/collaborator" \
--request POST \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--user "username:password" \
--data '{
  "collaborator_ids": ["usr1a2b3c4d5e6", "usr7f8g9h0i1j2"]
}'

    Corps de la réponse.

    {
  "result": {
    "message": "Collaborator(s) added successfully",
    "collaborators": [
      {
        "sys_id": "usr1a2b3c4d5e6", "name": "Jane Smith", "privacy_enabled": false,
        "routine": { "monday": true, "tuesday": true, "wednesday": false, "thursday": true, "friday": false, "saturday": false, "sunday": false },
        "exceptions": []
      },
      { "sys_id": "usr7f8g9h0i1j2", "name": "John Doe", "privacy_enabled": true, "routine": null, "exceptions": [] }
    ]
  }
}

    Présence WSD : POST /api/sn_wsd_concierge/v1/presence/exception

    Crée une exception de présence unique pour l’utilisateur authentifié à une date spécifique. Utilisez ce point de terminaison lorsqu’un utilisateur prévoit d’être au bureau un jour où il travaille normalement à distance, ou vice versa.

    Les exceptions remplacent la routine hebdomadaire de l’utilisateur pour cette date.

    Format d'URL

    URL versionnée : /api/sn_wsd_concierge/[api_version}/presence/exception

    URL par défaut : /api/sn_wsd_concierge/presence/exception

    Paramètres de demande pris en charge

    Tableau 49. 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 50. Paramètres de requête
    Nom Description
    Néant
    Tableau 51. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    exception Requis. Objet d’exception définissant le remplacement de présence ponctuelle.

    Type de données : objet

    "exception": { 
  "date": "String", 
  "in_office": "Boolean",
  "location": "String", 
  "origin": "String".
  "sys_id": "String"
}
    Date exception.exception Date de l’exception.

    Format : aaaa-MM-jj

    Type de données : chaîne
    exception.in_office Marqueur indiquant si l’utilisateur sera au bureau à cette date.
    Valeurs possibles :
    • vrai : l’utilisateur sera au bureau.
    • faux : l’utilisateur ne sera pas au bureau.

    Type de données : booléennes
    exception.emplacement Nom ou identificateur de l’emplacement du bureau pour cette exception.

    Type de données : chaîne
    exception.origine Source de l’exception.
    Valeurs valides :
    • user : créé manuellement par l’employé.
    • system : créé automatiquement par la plateforme.
    • manuel : créé par un administrateur ou au nom de l’utilisateur.
    Type de données : chaîne
    exception.sys_id Sys_id de l’exception existante à mettre à jour.

    Table : Exceptions relatives à la présence des employés (sn_wsd_concierge_employee_presence_exception)

    Type de données : chaîne

    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 52. 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, application/xmlou text/xml.
    Autorisation Informations d’identification d’authentification. Prend en charge l’authentification de base ou l’authentification basée sur la session.
    Type de contenu Format des données du corps de la demande : application/json.
    Tableau 53. En-têtes de réponses
    En-tête Description
    Type de contenu Format des données du corps de la réponse : application/json.

    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 54. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été traitée avec succès.
    400 Demande incorrecte. Date du champ obligatoire manquante ou format de date non valide.
    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 la réponse (JSON ou XML)

    Nom Description
    résultat Objet contenant le résultat de la demande.

    Type de données : objet

    "result": {
    "message": "String",
    "result": {Object}
  }
    résultat.message Message de confirmation indiquant que l’exception a été ajoutée.

    Type de données : chaîne
    résultat.résultat Objet contenant la ou les exceptions créées.

    Type de données : objet

    "result": {
 "exceptions": [Array]
}
    Résultat.Exceptions Tableau contenant des détails sur la ou les exceptions créées.

    Type de données : tableau d’objets

    "exceptions": [
 {
  "date": "String",
  "location": "String",
  "in_office": Boolean,
  "origin": "String",
  "sys_id": "String"
 }
]
    result.result.exceptions.date Date à laquelle s’applique cette exception, au format aaaa-MM-jj. Il s’agit de la date à laquelle la routine de l’utilisateur est remplacée.

    Type de données : chaîne
    result.result.exceptions.in_office Marqueur indiquant si l’utilisateur sera au bureau à cette date. Cela remplace tout ce que la routine hebdomadaire spécifie pour ce jour de la semaine.
    Valeurs valides :
    • vrai : l’utilisateur sera au bureau.
    • faux : l’utilisateur ne sera pas au bureau

    Type de données : chaîne
    Résultat.Résultat.Exceptions.Emplacement Nom ou identificateur de l’emplacement du bureau où l’utilisateur se trouvera à cette date. Pertinent uniquement lorsque in_office est vrai. Peut être une chaîne vide lorsque l’utilisateur est distant.

    Type de données : chaîne
    Résultat.Résultat.Exceptions.Origine Source qui a créé l’exception.
    Valeurs valides :
    • user : créé manuellement par l’employé.
    • system : créé automatiquement par la plateforme.
    • manuel : créé par un administrateur ou au nom de l’utilisateur.

    Type de données : chaîne
    result.result.exceptions.sys_id Sys_id de l’enregistrement d’exception.

    Table : Exceptions relatives à la présence des employés (sn_wsd_concierge_employee_presence_exception)

    Type de données : chaîne

    Demande cURL

    Cet exemple crée une exception de présence pour le 14 février 2026, marquant l’utilisateur comme étant au bureau dans le bâtiment A.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/exception" \
--request POST \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--user "username:password" \
--data '{
  "exception": {
    "date": "2026-02-14",
    "in_office": true,
    "location": "Building A - Floor 3",
    "origin": "user"
  }
}'

    Corps de la réponse.

    {
  "result": {
    "message": "Exception added successfully",
    "result": {
      "exceptions": [
        {
          "sys_id": "a1b2c3d4e5f6g7h8",
          "date": "2026-02-14",
          "in_office": true,
          "origin": "user",
          "location": "Building A - Floor 3"
        }
      ]
    }
  }
}

    Présence WSD : POST /api/sn_wsd_concierge/v1/presence/routine

    Crée une nouvelle routine hebdomadaire au bureau pour l’utilisateur authentifié. Utilisez ce point de terminaison lorsqu’un utilisateur configure sa routine de présence pour la première fois.

    Les sept jours de la semaine doivent être fournis en tant que valeurs booléennes.

    Format d'URL

    URL versionnée : /api/sn_wsd_concierge/{api_version}/presence/routine

    URL par défaut : /api/sn_wsd_concierge/presence/routine

    Paramètres de demande pris en charge

    Tableau 55. 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
    routine Requis. Routine hebdomadaire au bureau pour l’utilisateur.

    Contient un marqueur booléen pour chaque jour de la semaine indiquant la présence prévue au bureau. Affiche vrai lorsque l’utilisateur prévoit d’être au bureau ce jour-là et faux lorsque la présence n’est pas planifiée.

    Tous les jours sont requis.

    Type de données : objet

    "routine": { 
   "monday": "Boolean", 
   "tuesday": "Boolean", 
   "wednesday": "Boolean", 
   "thursday": "Boolean", 
   "friday": "Boolean", 
   "saturday": "Boolean", 
   "sunday": "Boolean" 
}
    Tableau 56. Paramètres de requête
    Nom Description
    Néant
    Tableau 57. Paramètres de corps de demande (XML ou JSON)
    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 58. 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, application/xmlou text/xml.
    Autorisation Informations d’identification d’authentification. Prend en charge l’authentification de base ou l’authentification basée sur la session.
    Type de contenu Format des données du corps de la demande : application/json.
    Tableau 59. En-têtes de réponses
    En-tête Description
    Type de contenu Format des données du corps de la réponse : application/json.

    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 60. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été traitée avec succès.
    400 Demande incorrecte. Champ(s) obligatoire(s) manquant(s) ou type de données non valide. Les sept jours doivent être fournis en tant que valeurs booléennes.
    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 la réponse (JSON ou XML)

    Nom Description
    résultat Objet contenant les résultats de la demande.

    Type de données : objet

    "result": {
 "message": "String",
 "result": {Object}
}
    résultat.message Message de confirmation indiquant que la routine a été créée.

    Type de données : chaîne
    résultat.résultat Contient l’objet de routine créé avec les sept jours.

    Type de données : objet

    "result": { 
  "routine": {Object} 
}
    résultat.routine Routine hebdomadaire de l’utilisateur au bureau.

    Contient un marqueur booléen pour chaque jour de la semaine indiquant la présence prévue au bureau. Affiche vrai lorsque l’utilisateur prévoit d’être au bureau ce jour-là et faux lorsque la présence n’est pas planifiée.

    Type de données : objet

    "routine": { 
  "monday": "Boolean", 
  "tuesday": "Boolean",
  "wednesday": "Boolean", 
  "thursday": "Boolean",
  "friday": "Boolean", 
  "saturday": "Boolean", 
  "sunday": "Boolean"
}

    Demande cURL

    Cet exemple crée une routine hebdomadaire au bureau du lundi au jeudi.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/routine" \
--request POST \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--user "username:password" \
--data '{
  "routine": {
    "monday": true, "tuesday": true, "wednesday": true,
    "thursday": true, "friday": false, "saturday": false, "sunday": false
  }
}'

    Corps de la réponse.

    {
  "result": {
    "message": "Routine created successfully",
    "result": {
      "routine": {
        "monday": true, 
        "tuesday": true, 
        "wednesday": true,
        "thursday": true, 
        "friday": false, 
        "saturday": false,
        "sunday": false
      }
    }
  }
}

    Présence WSD : PUT /api/sn_wsd_concierge/v1/présence/exception

    Met à jour une exception de présence existante en l’annulant et en créant un remplacement. L’exception d’origine est identifiée par son sys_id. Utilisez ce point de terminaison lorsqu’un utilisateur doit modifier les détails d’une exception créée précédemment.

    Format d'URL

    URL versionnée : /api/sn_wsd_concierge/{api_version}/presence/exception

    URL par défaut : /api/sn_wsd_concierge/presence/exception

    Paramètres de demande pris en charge

    Tableau 61. 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 62. Paramètres de requête
    Nom Description
    Néant
    Tableau 63. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    exception Requis. Objet d’exception contenant les détails mis à jour. Les sys_id champs et in_office sont obligatoires.

    Type de données : objet

    "exception": { 
  "date": "String", 
  "in_office": "Boolean",
  "location": "String", 
  "origin": "String",
  "sys_id": "String"
}
    Date exception.exception Date de l’exception.

    Format : aaaa-MM-jj

    Type de données : chaîne
    exception.in_office Requis. Marqueur indiquant si l’utilisateur sera au bureau à cette date.
    Valeurs possibles :
    • vrai : l’utilisateur sera au bureau.
    • faux : l’utilisateur ne sera pas au bureau.

    Type de données : booléennes
    exception.emplacement Nom ou identificateur de l’emplacement du bureau pour cette exception.

    Type de données : chaîne
    exception.origine Source de l’exception.
    Valeurs valides :
    • user : créé manuellement par l’employé.
    • system : créé automatiquement par la plateforme.
    • manuel : créé par un administrateur ou au nom de l’utilisateur.

    Type de données : chaîne

    Par défaut : user
    exception.sys_id Requis. Sys_id de l’exception existante à mettre à jour.

    Table : Exceptions relatives à la présence des employés (sn_wsd_concierge_employee_presence_exception)

    Type de données : chaîne

    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 64. 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, application/xmlou text/xml.
    Autorisation Informations d’identification d’authentification. Prend en charge l’authentification de base ou l’authentification basée sur la session.
    Type de contenu Format des données du corps de la demande : application/json.
    Tableau 65. En-têtes de réponses
    En-tête Description
    Type de contenu Format des données du corps de la réponse : application/json.

    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 66. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été traitée avec succès.
    400 Demande incorrecte. Champs obligatoires manquants sys_id ou in_office.
    404 Introuvable. L’exception spécifiée est introuvable ou l’utilisateur n’a pas l’autorisation de la modifier.
    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 la réponse (JSON ou XML)

    Nom Description
    résultat Objet contenant les résultats de la demande.

    Type de données : objet

    "result": {
    "message": "String",
    "result": {Object}
}
    résultat.message Message de confirmation indiquant que l’exception a été mise à jour.

    Type de données : chaîne
    résultat.résultat Contient la ou les exceptions mises à jour.

    Type de données : objet

    "result": {
  "exceptions": [Array]
}
    Résultat.Résultat.Exceptions Liste des exceptions de présence.

    Type de données : tableau d’objets

    "exceptions": [
 {
  "sys_id": "sys_id", 
  "date": "String", 
  "in_office": String, 
  "origin": "String", 
  "location": "String" 
 }
]
    result.result.exceptions.sys_id Sys_id de l’enregistrement d’exception.

    Table : Exceptions relatives à la présence des employés (sn_wsd_concierge_employee_presence_exception)

    Type de données : chaîne
    result.exceptions.date Date à laquelle s’applique cette exception, au format aaaa-MM-jj. Il s’agit de la date à laquelle la routine de l’utilisateur est remplacée.

    Type de données : chaîne
    result.exceptions.in_office Marqueur indiquant si l’utilisateur sera au bureau à cette date. Cela remplace tout ce que la routine hebdomadaire spécifie pour ce jour de la semaine.
    Valeurs valides :
    • vrai : l’utilisateur sera au bureau.
    • faux : l’utilisateur ne sera pas au bureau

    Type de données : chaîne
    résultat.exceptions.origine Source qui a créé l’exception.
    Valeurs valides :
    • user : créé manuellement par l’employé.
    • system : créé automatiquement par la plateforme.
    • manuel : créé par un administrateur ou au nom de l’utilisateur.

    Type de données : chaîne
    résultat.exceptions.emplacement Nom ou identificateur de l’emplacement du bureau où l’utilisateur se trouvera à cette date. Pertinent uniquement lorsque in_office est vrai. Peut être une chaîne vide lorsque l’utilisateur est distant.

    Type de données : chaîne

    Demande cURL

    Cet exemple met à jour une exception existante pour changer le statut de l’utilisateur en distant (pas au bureau) à la même date.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/exception" \
--request PUT \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--user "username:password" \
--data '{
  "exception": {
    "sys_id": "exc1a2b3c4d5e6",
    "in_office": false,
    "date": "2026-02-14",
    "location": "",
    "origin": "user"
  }
}'

    Corps de la réponse.

    {
  "result": {
    "message": "Exception updated successfully",
    "result": {
      "exceptions": [
        { "sys_id": "exc9k0l1m2n3o4", "date": "2026-02-14", "in_office": false, "origin": "user", "location": "" }
      ]
    }
  }
}