API reservável do WSD
. Prestação de serviços no local de trabalho(WSD) Reservável A API fornece endpoints para recuperar detalhes de um reservável, uma entidade que pode ser reservada, como um local de trabalho, de um ServiceNow instância.
Para acessar esta API, o solicitante deve ter a função sn_wsd_core.workplace_user.
Esta API é executada no sn_wsd_rsv namespace. Para acessar esta API, o plug-in Gestão de reservas do local de trabalho (sn_wsd_rsv) deve ser ativado.
Para obter informações adicionais sobre Gestão de reservas do local de trabalho, consulte Gestão de reservas do local de trabalho .
WSD reservável - OBTER /sn_wsd_rsv/reservable/list_reservables/
Retorna os detalhes de um ou mais reserváveis especificados.
Formato de URL
URL com controle de versão: /api/sn_wsd_rsv//reservable/list_reservables/
URL padrão: /api/sn_wsd_rsv/reservable/list_reservables/
Parâmetros de solicitação compatíveis
| Nome | Descrição |
|---|---|
| api_version | Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres |
| sys_ids | Sys_ids dos reserváveis cujos detalhes serão retornados. Se especificar vários reserváveis, separe os sys_ids por vírgulas. Tipo de dados: Cadeia de caracteres Tabela: Local do local de trabalho [sn_wsd_core_workplace_location] |
| Nome | Descrição |
|---|---|
| include_flexible_services | Sinalizador que indica se os serviços flexíveis associados ao reservável devem ser retornados para a resposta. Um serviço flexível é uma provisão adicional disponível com um item reservável do local de trabalho quando uma reserva é feita. Por exemplo, Estilo de sala de aula - Fileiras de mesas organizadas com todos os participantes voltados para a frente da sala. Para obter informações adicionais sobre serviços flexíveis, consulte Crie um serviço flexível . Valores válidos:
Tipo de dados: Booliano Padrão: falso |
| include_layouts | Sinalizador que indica se as informações de layout do local devem ser retornadas na resposta. As informações de layout do local incluem itens como capacidade, capacidade máxima, preparação e duração da limpeza. Essas informações estão localizadas na tabela Layout do local [sn_wsd_rsv_m2m_location_layout]. Valores válidos:
Tipo de dados: Booliano Padrão: falso |
| include_standard_services | Sinalizador que indica se as informações de serviços padrão devem ser retornadas na resposta. Essas informações estão localizadas na tabela Serviço padrão [sn_wsd_rsv_standard_service]. Um serviço padrão descreve provisões básicas disponíveis com um item reservável do local de trabalho quando a reserva é feita, como quadros brancos, monitores adicionais e serviços semelhantes. Para obter informações adicionais sobre serviços padrão, consulte Serviços padrão . Valores válidos:
Tipo de dados: Booliano Padrão: falso |
| reservable_module_sys_id | Obrigatório. Sys_id do módulo reservável. Um módulo reservável agrupa tipos semelhantes de itens do local de trabalho. Para obter informações adicionais sobre módulos reserváveis, consulte Configure um módulo reservável . Tipo de dados: Cadeia de caracteres Tabela: Módulo reservável [sn_wsd_rsv_reservable_module] |
| reservation_start_time | Hora de início da reserva para validar o lead time de serviços extras. Formato: Formato UTC, aaaa-MM-dd HH:mm:ss Tipo de dados: Cadeia de caracteres |
| Nome | Descrição |
|---|---|
| Nenhum(a) |
Cabeçalhos
Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .
| Cabeçalho | Descrição |
|---|---|
| Aceitar | Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json |
| Cabeçalho | Descrição |
|---|---|
| Nenhum(a) |
Códigos de status
Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .
| Código do status | Descrição |
|---|---|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 400 | Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada. |
| 401 | Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas. |
| 404 | Não encontrado. O item solicitado não foi encontrado. |
| 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. |
Parâmetros do corpo da resposta
| Nome | Descrição |
|---|---|
| resultado | Detalhes sobre cada reservável correspondente. Tipo de dados: Matriz de objetos |
| allow_invites | Sinalizador que indica se os funcionários podem adicionar convidados à reserva. Valores válidos:
Tipo de dados: Booliano |
| result.area | Área onde o reservável está localizado. Tipo de dados: Objeto Tabela: Área [sn_wsd_core_area] |
| result.area.display_value | Valor de exibição da área. Tipo de dados: Cadeia de caracteres |
| result.area.sys_id | Sys_id do registro de área associado. Tipo de dados: Cadeia de caracteres |
| resultado.criação | Edifício onde o reservável está localizado. Tipo de dados: Objeto Tabela: Criando [sn_wsd_core_building] |
| result.building.display_value | Valor de exibição do edifício. Tipo de dados: Cadeia de caracteres |
| result.building.sys_id | Sys_id do registro de edifício associado. Tipo de dados: Cadeia de caracteres |
| building.timezone.result.building | Detalhes do fuso horário do edifício. Tipo de dados: Objeto |
| result.building.timezone.display_value | Valor de exibição do fuso horário no qual o edifício associado reside. Tipo de dados: Cadeia de caracteres |
| resultado.building.timezone.value | Valor interno do fuso horário no qual o edifício associado reside. Tipo de dados: Cadeia de caracteres |
| result.campus | Campus onde o reservável está localizado. Tipo de dados: Objeto Tabela: Campus [sn_wsd_core_campus] |
| result.campus.display_value | Valor de exibição do campus. Tipo de dados: Cadeia de caracteres |
| result.campus.sys_id | Sys_id do registro do campus associado. Tipo de dados: Cadeia de caracteres |
| result.capacity | Número de pessoas que o reservável pode acomodar. Tipo de dados: Número |
| result.description | Descrição do reservável. Tipo de dados: Cadeia de caracteres |
| display_number_of_attendentes | Sinalizador que indica se os usuários podem especificar o número de participantes na reserva. Valores válidos:
Tipo de dados: Booliano |
| resultado.display_on_nome_of | Sinalizador que indica se as reservas podem ser feitas em nome de outra pessoa. Valores válidos:
Tipo de dados: Booliano |
| resultado.display_sensitivity | Sinalizador que indica se os usuários podem definir a sensibilidade da reserva, como normal ou privado. Valores válidos:
Tipo de dados: Booliano |
| resultado.e-mail | Endereço de e-mail associado ao reservável. Tipo de dados: Cadeia de caracteres |
| employee_override_privacy | Sinalizador que indica se os usuários podem substituir a configuração de privacidade do reservável associado. Para obter informações adicionais sobre essas configurações de privacidade, consulte Configurações de privacidade do local e impacto . Valores válidos:
|
| enable_group_reservations | Sinalizador que indica se os usuários podem fazer uma reserva de grupo. Valores válidos:
Tipo de dados: Booliano |
| enable_reservation_privacy | Sinalizador que indica a configuração padrão para privacidade de reserva. Para obter informações adicionais sobre essas configurações de privacidade, consulte Location privacy settings and impact. Valores possíveis:
Tipo de dados: Booliano |
| result.external_id | ID externo do reservável. Tipo de dados: Cadeia de caracteres |
| result.flexible_services | Preenchido somente se include_flexible_serviceso parâmetro está definido como verdadeiro e o plug-in de gestão de casos do local de trabalho está instalado. Descrição dos serviços flexíveis associados aos reserváveis. Pode haver um serviço flexível primário e vários serviços flexíveis secundários. Tipo de dados: Objeto Tabela: Item de serviço do local de trabalho [sn_wsd_case_workplace_service_item] |
| result.flexible_services.additional_text | Texto para solicitar que o usuário selecione serviços flexíveis adicionais. Tipo de dados: Cadeia de caracteres |
| result.flexible_services.allow_only_single_service_item_selection | Sinalizador que indica se os usuários podem selecionar apenas um item de serviço entre o grupo de serviços flexíveis em uma reserva. Valores válidos:
Tipo de dados: Booliano |
| result.flexible_services.category | Categoria dos serviços flexíveis. Tipo de dados: Cadeia de caracteres |
| result.flexible_services.currency_code | Código da moeda usado para calcular o valor da moeda ao solicitar serviços flexíveis. Tipo de dados: Cadeia de caracteres |
| result.flexible_services.flexible_service | Serviços flexíveis correspondentes a um serviço flexível primário. Tipo de dados: Matriz de objetos Tabela: Item de serviço do local de trabalho [sn_wsd_case_workplace_service_item] |
| result.flexible_services.flexible_service.flexible_service | Detalhes de cada serviço flexível correspondente a um serviço flexível primário. Tipo de dados: Matriz de objetos |
| flexible_services.flexible_service. flexible_service.additional_text | Texto usado para solicitar que um usuário selecione serviços flexíveis adicionais. Tipo de dados: Cadeia de caracteres |
| result.flexible_services.flexible_service.flexible_service.capacity_enabled | Sinalizador que indica se a capacidade da sala deve aparecer na reserva. Se estiver definido como verdadeiro, quantity_enabledsempre será falso. Valores válidos:
Tipo de dados: Booliano |
| result.flexible_services.flexible_service.flexible_service.category | Categoria do serviço flexível. Tipo de dados: Cadeia de caracteres |
| result.flexible_services.flexible_service.flexible_service.category_label | Rótulo da categoria do serviço flexível. Tipo de dados: Cadeia de caracteres |
| flexible_services.flexible_service. flexible_service.cleanup_duration | Tempo necessário para limpar ou remover o serviço adicionado ao reservável. Tipo de dados: Número Unidade: Milissegundos |
| flexible_services.flexible_service. flexible_service.image | Link para a imagem do serviço flexível. Tipo de dados: Cadeia de caracteres |
| flexible_services.flexible_service. flexible_service.max_capacity | Número máximo de ocupantes que o reservável pode acomodar. Tipo de dados: Número |
| result.flexible_services.flexible_service.flexible_service.name | Nome do serviço flexível. Tipo de dados: Cadeia de caracteres |
| flexible_services.flexible_service. flexible_service.preparation_duration | Tempo necessário para adicionar o serviço ao reservável. Tipo de dados: Cadeia de caracteres Unidade: Milissegundos |
| flexible_services.flexible_service.flexible_service.price_per_unit | Detalhes do custo de adicionar o serviço flexível ao reservável. Tipo de dados: Objeto |
| flexible_services.flexible_service. flexible_service.price_per_unit.code | Código da moeda a ser usado ao calcular o custo, como GBP ou USD. Tipo de dados: Cadeia de caracteres |
| flexible_services.flexible_service. flexible_service.price_per_unit.value | Custo para cada unidade do serviço flexível na moeda definida no parâmetro de código. Tipo de dados: Cadeia de caracteres |
| flexible_services.flexible_service. flexible_service.quantity_enabled | Sinalizador que indica se o campo Quantidade deve aparecer na reserva. Se estiver definido como verdadeiro, capacity_enabledsempre será falso. Valores válidos:
Tipo de dados: Booliano |
| flexible_services.flexible_service.flexible_service.quantity_required | Sinalizador que indica se a quantidade é necessária. Valores válidos:
Tipo de dados: Booliano |
flexible_services.flexible_service. flexible_service.short_description |
Breve descrição do serviço flexível. Tipo de dados: Cadeia de caracteres |
| flexible_services.flexible_service. flexible_service.sub_category | Nome da subcategoria do serviço flexível, como chair_layout. Tipo de dados: Cadeia de caracteres |
| flexible_services.flexible_service. flexible_service.sub_category_label | Rótulo da subcategoria do serviço flexível, como Layout da cadeira. Tipo de dados: Cadeia de caracteres |
| flexible_services.flexible_service. flexible_service.sub_title | Nome do subtítulo do serviço flexível secundário. Tipo de dados: Cadeia de caracteres |
| flexible_services.flexible_service. flexible_service.sys_id | Sys_id do serviço flexível. Tipo de dados: Cadeia de caracteres |
| flexible_services.flexible_service. flexible_service.text | Texto usado para solicitar que um usuário selecione serviços flexíveis. Tipo de dados: Cadeia de caracteres |
| result.flexible_services.flexible_service. flexible_service.title | Detalhes dos títulos a serem usados ao adicionar e editar o serviço flexível secundário na IU. Tipo de dados: Objeto |
| flexible_services.flexible_service. flexible_service.title.add | Título usado ao adicionar um serviço flexível secundário na IU. Tipo de dados: Cadeia de caracteres |
| flexible_services.flexible_service. flexible_service.title.edit | Título usado ao editar um serviço flexível secundário na IU. Tipo de dados: Cadeia de caracteres |
| result.flexible_services.flexible_service.label | Rótulo de serviço flexível. Tipo de dados: Cadeia de caracteres |
| result.flexible_services.flexible_service.sub_category | Subcategoria dos serviços flexíveis primários, como cadeira adicional. Tipo de dados: Cadeia de caracteres |
| result.flexible_services.flexible_service.sub_title | Nome do subtítulo do serviço flexível primário. Tipo de dados: Cadeia de caracteres |
| result.flexible_services.flexible_service.text | Texto usado para solicitar que um usuário selecione serviços flexíveis primários. Tipo de dados: Cadeia de caracteres |
| result.flexible_services.flexible_service.title | Detalhes dos títulos a serem usados ao adicionar e editar o serviço flexível primário na IU. Tipo de dados: Objeto |
| result.flexible_services.flexible_service.title.adicionar | Título usado ao adicionar um serviço flexível primário na IU. Tipo de dados: Cadeia de caracteres |
| result.flexible_services.flexible_service.title.editar | Título usado ao editar um serviço flexível primário na IU. Tipo de dados: Cadeia de caracteres |
| resultado.andar | Detalhes sobre o andar em que o reservável está localizado. Tipo de dados: Objeto Tabela: Andar [sn_wsd_core_floor] |
| floor.display_value | Número de exibição do andar em que o reservável reside, como 12. Tipo de dados: Cadeia de caracteres |
| result.floor.sys_id | Sys_id do registro associado na tabela Andar. Tipo de dados: Cadeia de caracteres |
| result.image | Detalhes sobre uma imagem que representa o reservável associado. Tipo de dados: Objeto Tabela: Imagens [db_image] |
| result.image.link | Link para uma imagem que representa o reservável. Tipo de dados: Cadeia de caracteres |
| result.image.sys_id | Sys_id do registro de imagem associado. Tipo de dados: Cadeia de caracteres |
| result.is_reservable | Sinalizador que indica se o serviço flexível pode ser reservado. Valores válidos:
Tipo de dados: Booliano |
| layouts.results | Preenchido somente se include_layoutso parâmetro está definido como verdadeiro. Lista de layouts associados ao reservável. Tipo de dados: Matriz de objetos
|
| result.layouts.capacity | Número de pessoas que assistirão à reunião. Tipo de dados: Número |
| result.layouts.cleanup_duration | Tempo necessário para limpar o reservável para este layout. Tipo de dados: Número Unidade: Milissegundos |
| result.layouts.image | Detalhes sobre uma imagem que representa o layout do reservável associado. Tipo de dados: Objeto Tabela: Imagens [db_image] |
| result.layouts.image.link | Link para uma imagem que representa o layout deste reservável. Tipo de dados: Cadeia de caracteres Tabela: Imagens [db_image] |
| result.layouts.image.sys_id | Sys_id do registro de imagem associado. Tipo de dados: Cadeia de caracteres |
| result.layouts.is_default | Sinalizador que indica se o layout associado é o padrão para o reservável. Valores válidos:
Tipo de dados: Booliano |
| result.layouts.max_capacity | Número máximo de pessoas que o layout associado ao reservável pode acomodar. Tipo de dados: Número |
| result.layouts.name | Nome do layout do local. Tipo de dados: Cadeia de caracteres |
| result.layouts.preparation_duration | Tempo necessário para preparar o layout do local associado. Tipo de dados: Número Unidade: Milissegundos |
| result.layouts.short_description | Breve descrição do layout do local. Tipo de dados: Cadeia de caracteres |
| result.layouts.sys_id | Sys_id do layout do local. Tipo de dados: Cadeia de caracteres Tabela: Layout [sn_wsd_rsv_layout] |
| result.location_type | Detalhes sobre o tipo de local do reservável, como local de trabalho/mesa, café ou academia. Tipo de dados: Objeto Tabela: Tipo de espaço [sn_wsd_core_space_type] |
| result.location_type.display_value | Valor de exibição do tipo de local. Tipo de dados: Cadeia de caracteres |
| result.location_type.sys_id | Sys_id do registro associado. Tipo de dados: Cadeia de caracteres Tabela: Tipo de espaço [sn_wsd_core_space_type] |
| MeetingProviders | Detalhes sobre os provedores de reunião virtual associados ao reservável. Tipo de dados: Matriz de objetos Tabela: Provedor de reunião virtual [sn_wsd_rsv_virtual_meeting_provider] |
| MeetingProviders.display_value | Valor de exibição do nome do provedor virtual. Tipo de dados: Cadeia de caracteres |
| Result.meetingProviders.Value | Valor real do nome do provedor virtual no registro. Tipo de dados: Cadeia de caracteres |
| Result.ModuleType | Módulo reservável associado ao reservável, como mesas ou sala de reunião. Tipo de dados: Cadeia de caracteres |
| result.name | Nome do reservável. Tipo de dados: Cadeia de caracteres |
| resultado.número | Identificador exclusivo do reservável. Este valor é mais legível do que o sys_id. Tipo de dados: Cadeia de caracteres |
| resultado.ordem | Número do pedido do reservável. Tipo de dados: Número |
| require_approval | Sinalizador que indica se a reserva do reservável requer uma aprovação. Valores possíveis:
Tipo de dados: Booliano |
| result.requires_check_in | Sinalizador que indica se o reservável requer que o usuário faça check-in. Valores válidos:
Tipo de dados: Booliano |
| result.require_subject | Sinalizador que indica se o usuário deve inserir um assunto ao fazer a reserva. Valores válidos:
Tipo de dados: Booliano |
| reservable_quantity | Número máximo de vezes que o reservável associado pode ser reservado para o mesmo horário. Este valor é usado ao atribuir espaços de bairro a uma área. Tipo de dados: Inteiro |
| result.site | Detalhes sobre o site onde o reservável reside. Tipo de dados: Objeto Tabela: Site [sn_wsd_core_site] |
| result.site.display_value | Valor de exibição do site. Tipo de dados: Cadeia de caracteres |
| result.standard_services | Preenchido somente se include_standard_serviceso parâmetro está definido como verdadeiro. Serviços padrão associados, como flipchart, tela de projetor, quadro branco e marcadores. Tipo de dados: Matriz de objetos
|
| result.standard_services.font_awesome_icon | Nome do ícone de miniatura associado ao serviço padrão. Tipo de dados: Cadeia de caracteres |
| result.standard_services.name | Nome do serviço padrão. Tipo de dados: Cadeia de caracteres |
| result.standard_services.short_description | Breve descrição do serviço padrão. Tipo de dados: Cadeia de caracteres |
| result.standard_services.sys_id | Sys_id do registro de serviço padrão. Tipo de dados: Cadeia de caracteres Tabela: Serviço padrão [sn_wsd_rsv_standard_service] |
| result.site.sys_id | Sys_id do registro do site associado. Tipo de dados: Cadeia de caracteres Tabela: Site [sn_wsd_core_site] |
| Result.tablename | Nome da tabela na qual o registro reservável reside. Tipo de dados: Cadeia de caracteres |
| result.title | Título do reservável. Tipo de dados: Cadeia de caracteres |
| result.type | Tipo de reservável, como local. Tipo de dados: Cadeia de caracteres |
Solicitação de curl
O exemplo de código a seguir mostra como chamar este endpoint.
curl "http://instance.servicenow.com/api/sn_wsd_rsv/reservable/list_reservables/dad3df5977220110b3d7be377b5a99ce,3ed3139977220110b3d7be377b5a99d1?include_flexible_services=true&include_layouts=false&include_reservable_purposes=true&include_standard_services=true&reservable_module_sys_id=c31241cedb7650106c731dcd13961917" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
Resultados de retorno:
{
"result": [
{
"sys_id": "3e41e94adb7210106c731dcd1396198c",
"external_id": null,
"wsd_email": null,
"name": "A1-02-04",
"title": "A1-02-04",
"description": "General desk available for reservation.",
"image": null,
"number": "SPCE0009004",
"site": {
"sys_id": "628eec06db7650106c731dcd139619dd",
"display_value": "North America"
},
"campus": {
"sys_id": "82b2a0cedb3650106c731dcd139619e9",
"display_value": "California Campus"
},
"building": {
"sys_id": "94e264cedb3650106c731dcd13961919",
"display_value": "CAL-B1",
"timezone": {
"value": "US/Pacific",
"displayValue": "US/Pacific"
}
},
"floor": {
"sys_id": "fc7368cedb3650106c731dcd13961902",
"display_value": "Floor 1"
},
"area": null,
"capacity": "1",
"reservable_quantity": null,
"location_type": {
"sys_id": "5f017383eb512010b89bfdfc9c5228c8",
"display_value": "Workspace/Desk"
},
"order": null,
"requires_check_in": null,
"is_reservable": "1",
"type": "location",
"moduleType": "Desks",
"meetingProviders": [],
"require_subject": false,
"allow_invitees": true,
"display_number_of_attendees": false,
"display_on_behalf_of": true,
"display_sensitivity": false,
"enable_group_reservations": false,
"enable_reservation_privacy": true,
"employee_override_privacy": true,
"tableName": "sn_wsd_core_space",
"require_approval": false
},
{
"sys_id": "fd41a94adb7210106c731dcd1396195a",
"external_id": null,
"wsd_email": null,
"name": "A1-02-03",
"title": "A1-02-03",
"description": "General desk available for reservation.",
"image": null,
"number": "SPCE0009003",
"site": {
"sys_id": "628eec06db7650106c731dcd139619dd",
"display_value": "North America"
},
"campus": {
"sys_id": "82b2a0cedb3650106c731dcd139619e9",
"display_value": "California Campus"
},
"building": {
"sys_id": "94e264cedb3650106c731dcd13961919",
"display_value": "CAL-B1",
"timezone": {
"value": "US/Pacific",
"displayValue": "US/Pacific"
}
},
"floor": {
"sys_id": "fc7368cedb3650106c731dcd13961902",
"display_value": "Floor 1"
},
"area": null,
"capacity": "1",
"reservable_quantity": null,
"location_type": {
"sys_id": "5f017383eb512010b89bfdfc9c5228c8",
"display_value": "Workspace/Desk"
},
"order": null,
"requires_check_in": null,
"is_reservable": "1",
"type": "location",
"moduleType": "Desks",
"meetingProviders": [],
"require_subject": false,
"allow_invitees": true,
"display_number_of_attendees": false,
"display_on_behalf_of": true,
"display_sensitivity": false,
"enable_group_reservations": false,
"enable_reservation_privacy": true,
"employee_override_privacy": true,
"tableName": "sn_wsd_core_space",
"require_approval": false
}
]
}