API de solicitação de serviço extra do WSD

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 5 min. de leitura

    • . Prestação de serviços no local de trabalho(WSD) Solicitação de serviço extra A API fornece endpoints para gerenciar solicitações de serviço extras para reservas.

    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 obter informações adicionais sobre Gestão de reservas do local de trabalho, consulte Gestão de reservas do local de trabalho .

    WSD Extra Service - OBTENHA /sn_wsd_rsv/extra_service/list_loc_layouts

    Retorna os detalhes sobre os layouts de local associados para um local de trabalho especificado.

    Formato de URL

    URL com controle de versão: /api/sn_wsd_rsv//extra_service/list_loc_layouts

    URL padrão: /api/sn_wsd_rsv/extra_service/list_loc_layouts

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

    Parâmetros de solicitação compatíveis

    Tabela 1. Parâmetros de caminho
    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
    Tabela 2. Parâmetros de consulta
    Nome Descrição
    local Obrigatório. Sys_id do local do local do local de trabalho para o qual retornar os detalhes do layout do local.

    Tipo de dados: Cadeia de caracteres

    Tabela: Local do local de trabalho [sn_wsd_core_workplace_location]
    Tabela 3. Parâmetros do corpo da solicitação
    Nome Descrição
    Nenhum(a) Obrigatório.

    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 .

    Tabela 4. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json
    Tabela 5. Cabeçalhos de resposta
    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 .

    Tabela 6. Códigos de status
    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.
    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 Lista de layouts associados ao local do local do local de trabalho especificado.

    Tipo de dados: Matriz de objetos

    "result": [
  {
    "capacity": Number,
    "cleanup_duration": "String",
    "image": {Object},
    "is_default": Boolean,
    "max_capacity": Number,
    "name": "String",
    "preparation_duration": "String",
    "short_description": "String",
    "sys_id": "String"
  }
]
    result.capacity Número de pessoas que assistirão à reunião.

    Tipo de dados: Número
    result.cleanup_duration Tempo necessário para limpar o reservável para este layout.

    Tipo de dados: Número

    Unidade: Milissegundos
    result.image Detalhes sobre uma imagem que representa o layout do reservável associado.

    Tipo de dados: Objeto

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

    Tabela: Imagens [db_image]
    result.image.link Link para uma imagem que representa o layout deste reservável.

    Tipo de dados: Cadeia de caracteres

    Tabela: Imagens [db_image]
    result.image.sys_id Sys_id do registro de imagem associado.

    Tipo de dados: Cadeia de caracteres
    result.is_default Sinalizador que indica se o layout associado é o padrão para o reservável.
    Valores válidos:
    • Verdadeiro: Padrão.
    • Falso: Não padrão.

    Tipo de dados: Booliano
    result.name Nome do layout do local.

    Tipo de dados: Cadeia de caracteres
    result.max_capacity Número máximo de pessoas que o layout associado ao reservável pode acomodar.

    Tipo de dados: Número
    result.preparation_duration Tempo necessário para preparar o layout do local associado.

    Tipo de dados: Número

    Unidade: Milissegundos
    resultado.short_description Breve descrição do layout do local.

    Tipo de dados: Cadeia de caracteres
    sys_id.result.sys_id Sys_id do layout do local.

    Tipo de dados: Cadeia de caracteres

    Tabela: Layout [sn_wsd_rsv_layout]

    Solicitação de curl

    O exemplo de código a seguir mostra como chamar este endpoint.

    "http://instance.servicenow.com/api/sn_wsd_rsv/extra_service/list_loc_layouts&location=d2716d4adb7210106c731dcd13961994" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

    Resultados de retorno:

    {
  "result": [
    {
      "sys_id": "f4fee556534301103cf7ddeeff7b12ed",
      "name": "Test",
      "short_description": "test",
      "is_default": false,
      "image": {
        "sys_id": "9648a7c5531301103cf7ddeeff7b1286",
        "link": "9648a7c5531301103cf7ddeeff7b1286.iix"
      },
      "capacity": null,
      "max_capacity": null,
      "preparation_duration": 172800000,
      "cleanup_duration": 86400000
    }
  ]
}

    WSD Extra Service - OBTENHA /api/sn_wsd_rsv/extra_service/list_loc_standard_services

    Retorna os detalhes sobre os serviços padrão associados para um local de trabalho especificado.

    Formato de URL

    URL com controle de versão: /api/sn_wsd_rsv//extra_service/list_loc_standard_services

    URL padrão: /api/sn_wsd_rsv/extra_service/list_loc_standard_services

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

    Parâmetros de solicitação compatíveis

    Tabela 7. Parâmetros de caminho
    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
    Tabela 8. Parâmetros de consulta
    Nome Descrição
    local Obrigatório. Sys_id do local do local do local de trabalho para o qual retornar os serviços padrão de layout do local.

    Tipo de dados: Cadeia de caracteres

    Tabela: Local do local de trabalho [sn_wsd_core_workplace_location]
    Tabela 9. Parâmetros do corpo da solicitação
    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 .

    Tabela 10. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json
    Tabela 11. Cabeçalhos de resposta
    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 .

    Tabela 12. Códigos de status
    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.
    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
    result.standard_services
    Serviços padrão associados, como flipchart, tela de projetor, quadro branco e marcadores.

    Tipo de dados: Matriz de objetos

    "standard_services": [
  {
    "font_awesome_icon": "String",
    "name": "String",
    "short_description": "String",
    "sys_id": "String"
  }
]
    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]

    Solicitação de curl

    O exemplo de código a seguir mostra como chamar este endpoint para obter os serviços padrão.

    "http://instance.servicenow.com/api/sn_wsd_rsv/extra_service/list_loc_standard_services&location=d2716d4adb7210106c731dcd13961994" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

    Resultados de retorno:

    {
  "result": [
    {
      "sys_id": "9b01458edb7650106c731dcd13961945",
      "name": "Flip chart",
      "short_description": "Flip chart with paper sheets",
      "font_awesome_icon": "fa-calendar-o"
    },
    {
      "sys_id": "abd0c18edb7650106c731dcd13961965",
      "name": "Projector screen",
      "short_description": "Connect laptop to screen (HDMI and DVI)",
      "font_awesome_icon": "fa-caret-square-o-right"
    },
    {
      "sys_id": "9841858edb7650106c731dcd1396193c",
      "name": "Whiteboard",
      "short_description": "Whiteboard and markers",
      "font_awesome_icon": "fa-pencil-square-o"
    }
  ]
}