API de reserva múltipla WSD

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

    • . Prestação de serviços no local de trabalho(WSD) Reserva múltipla A API fornece endpoints para gerenciar reservas com vários locais de local de trabalho.

    Para acessar esta API, o solicitante deve ter a função sn_wsd_core.workplace_user e os plug-ins Gestão de segurança no local de trabalho (sn_wsd_core) e Gestão de reservas no local de trabalho (sn_wsd_rsv) devem estar ativados.

    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 Multi Reservation - PATCH /api/sn_wsd_rsv/multi_reservation/cancel/

    Cancela uma reserva múltipla especificada.

    Formato de URL

    URL com controle de versão: /api/sn_wsd_rsv//multi_reservation/cancel/sys_id

    URL padrão: /api/sn_wsd_rsv/multi_reservation/cancel/

    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
    sys_id Sys_id da reserva múltipla a ser cancelada.

    Tipo de dados: Cadeia de caracteres

    Tabela: Reserva do local de trabalho [sn_wsd_rsv_reservation]
    Tabela 2. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 3. Parâmetros do corpo da solicitação
    Nome Descrição
    cancel_notes Motivo para cancelar a reserva.

    Tipo de dados: Cadeia de caracteres

    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 solicitação. Tipos compatíveis: application/json, application/xmlou, text/xml.

    Padrão: application/json
    Tipo de conteúdo Formato de dados do corpo da solicitação. Oferece suporte somente a 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.
    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 dos resultados da solicitação de cancelamento.

    Tipo de dados: Objeto

    "result": {
  "error": "String",
  "parent": "String",
  "success": Boolean,
  "successfulReservations": [Array],
  "unSuccessfulReservations": [Array]
}
    resultado.erro Mensagem que descreve o erro associado.

    Tipo de dados: Cadeia de caracteres
    resultado.primário Sys_id da reserva primária. Um primário pode ter uma ou mais reservas secundárias associadas a ele.

    Tipo de dados: Cadeia de caracteres
    resultado.sucesso Sinalizador que indica se a reserva foi cancelada com sucesso.
    Valores possíveis:
    • Verdadeiro: Cancelado com sucesso.
    • Falso: A reserva não foi cancelada.

    Tipo de dados: Booliano
    Result.successfulReservations Detalhes sobre o cancelamento bem-sucedido da reserva múltipla.

    Tipo de dados: Matriz de objetos

    "successfulReservations": [
  {
    "msg": "String",
    "success": Boolean,
    "sys_id": "String"
  }
]
    result.successfulReservations.msg Mensagem de cancelamento.

    Tipo de dados: Cadeia de caracteres
    SuccessfulReservas.Sucesso Sinalizador que indica se a reserva foi cancelada com sucesso.
    Valores possíveis:
    • Verdadeiro: Cancelado com sucesso.
    • Falso: Falha na operação.

    Tipo de dados: Booliano
    Result.successfulReservations.sys_id Sys_id da reserva que foi cancelada.

    Tipo de dados: Cadeia de caracteres

    Tabela: Reserva do local de trabalho [sn_wsd_rsv_reservation]
    Resultado.Reservas sem sucesso Detalhes sobre o cancelamento malsucedido da reserva múltipla.

    Tipo de dados: Matriz de objetos

    "unSuccessfulReservations": [
  {
    "msg": "String",
    "success": Boolean,
    "sys_id": "String"
  }
]
    result.unSuccessfulReservations.msg Mensagem de cancelamento.

    Tipo de dados: Cadeia de caracteres
    Reservas.Sem Sucesso.Sucesso.Sucesso Sinalizador que indica se a reserva foi cancelada com sucesso.
    Valores possíveis:
    • Verdadeiro: Cancelado com sucesso.
    • Falso: Falha na operação.

    Tipo de dados: Booliano
    UnSuccessfulReservations.sys_id Sys_id da reserva que não foi cancelada.

    Tipo de dados: Cadeia de caracteres

    Tabela: Reserva do local de trabalho [sn_wsd_rsv_reservation]

    Solicitação de curl

    O exemplo de código a seguir mostra como cancelar várias reservas.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/cancel/1b1fdf5987ab01506342b846dabb35ec" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{\"cancel_notes\":\"Meeting no longer needed.\"}" \ 
--user "username":"password’"

    Resultados de retorno:

    {
  "result": {
    "success": true,
    "successfulReservations": [
      {
        "success": true,
        "msg": "Cancelled successfully.",
        "sys_id": "5b1f9f1d87ab01506342b846dabb35a4"
      },
      {
        "success": true,
        "msg": "Cancelled successfully.",
        "sys_id": "931f9f1d87ab01506342b846dabb35a0"
      }
    ],
    "unSuccessfulReservations": [],
    "error": null,
    "parent": "1b1fdf5987ab01506342b846dabb35ec"
  }
}

    WSD Multi Reservation - PATCH /api/sn_wsd_rsv/multi_reservation/update/

    Atualiza as reservas associadas a uma reserva múltipla em que a mesma reserva (reunião) tem vários locais de trabalho.

    Este endpoint pode lidar com quatro cenários de atualização diferentes:
    1. Atualize o conteúdo do registro de várias reservas, como assunto, data ou hora.
    2. Converta a reserva múltipla em uma única reserva com base no primário (reserva para um único local de trabalho).
    3. Converta uma única reserva (reserva para um único local de trabalho) em uma reserva múltipla.
    4. Adicione ou remova um local de trabalho a uma reserva múltipla existente.

    Formato de URL

    URL com controle de versão: /api/sn_wsd_rsv//multi_reservation/update/ sys_id

    URL padrão: /api/sn_wsd_rsv/multi_reservation/update/

    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
    sys_id Sys_id da reserva a ser atualizada.
    • Reserva única para várias reservas: Sys_id da reserva única.

      Tabela: Reserva do local de trabalho [sn_wsd_rsv_reservation]

    • Atualize o conteúdo da reserva múltipla: Sys_id do registro de reserva primário.

      Tabela: Reserva do local de trabalho [sn_wsd_rsv_reservation]

    Para obter os detalhes de uma reserva de vários primários do registro secundário, consulte o sys_id no campo source_reservation do registro secundário.

    Tipo de dados: Cadeia de caracteres
    Tabela 8. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 9. Parâmetros do corpo da solicitação
    Nome Descrição
    término Necessário se shifto parâmetro não foi passado. Hora de término solicitada da reserva.

    Tipo de dados: Cadeia de caracteres

    Formato: UTC ou hora local (aaaa-mm-dd hh:mm:ss)
    requested_for Sys_id ou endereço de e-mail do usuário para o qual a reserva está sendo feita.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    reserváveis Lista de detalhes sobre os reserváveis associados à reserva.

    Tipo de dados: Matriz de objetos

    "reservables": [
  {
    "is_private": Boolean,
    "sys_id": "String"
  }
]
    reservables.is_private Sinalizador que indica se a reserva é privada. Se for privada, a reserva não aparecerá para ninguém, exceto o proprietário.

    Para obter informações adicionais sobre essas configurações de privacidade, consulte Configurações de privacidade do local e impacto .

    Valores válidos:
    • Verdadeiro: A reserva é privada.
    • Falso: A reserva não é privada.

    Tipo de dados: Booliano

    Valor definido para privacidade nas propriedades do sistema.
    reservables.sys_id Sys_id do local no qual fazer as reservas.

    Tipo de dados: Cadeia de caracteres

    Tabela: Local do local de trabalho [sn_wsd_core_workplace_location]
    reservable_module Obrigatório. Sys_id do módulo reservável a ser associado à reserva. . módulo reservável define os itens do local de trabalho necessários para uma reserva.

    Tipo de dados: Cadeia de caracteres

    Tabela: Módulo reservável [sn_wsd_rsv_reservable_module]
    shift
    Sys_id do turno a ser associado à reserva. Se este parâmetro for passado, o endo parâmetro não é necessário.

    Para obter informações adicionais sobre reservas baseadas em turno, consulte Habilitar reserva baseada em turno .

    Tipo de dados: Cadeia de caracteres

    Tabela: Shift [sn_wsd_core_shift]
    início Obrigatório. Hora de início solicitada da reserva.

    Tipo de dados: Cadeia de caracteres

    Formato: UTC ou hora local (aaaa-mm-dd hh:mm:ss)
    assunto
    Assunto da reunião associada à reserva.

    Tipo de dados: Cadeia de caracteres

    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 solicitação. Tipos compatíveis: application/json, application/xmlou, text/xml.

    Padrão: application/json
    Tipo de conteúdo Formato de dados do corpo da solicitação. Oferece suporte somente a 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.
    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 Retornar resultados da criação ou atualização de várias reservas.

    Tipo de dados: Objeto

    "result": {
  "parent": "String",
  "success": Boolean,
  "successfulReservations": [Array],
  "unSuccessfulReservations": [Array]
}
    resultado.primário Sys_id da reserva primária. Um primário pode ter uma ou mais reservas secundárias associadas a ele.

    Tipo de dados: Cadeia de caracteres
    resultado.sucesso Sinalizador que indica se a reserva foi criada com sucesso.
    Valores possíveis:
    • Verdadeiro: Criado com sucesso.
    • Falso: Falha na operação.

    Tipo de dados: Booliano
    Result.successfulReservations Lista de reservas que foram criadas com sucesso.

    Tipo de dados: Matriz de objetos

    "successfulReservations": [
  {
    "cancelled": Boolean,
    "error": "String",
    "reservable": "String"
    "success": Boolean,
    "sys_id": "String",
    "updated": Boolean
  }
]
    result.successfulReservations.canceled Sinalizador que indica se a reserva foi cancelada com sucesso.
    Valores possíveis:
    • Verdadeiro: Cancelado com sucesso.
    • Falso: Não cancelado.

    Tipo de dados: Booliano
    Result.successfulReservations.ERROR Mensagem de erro se houve um problema ao criar a reserva.

    Tipo de dados: Cadeia de caracteres
    result.SuccessfulReservations.insert Sinalizador que indica se a reserva foi inserida com sucesso. Quando uma reserva é adicionada.
    Valores possíveis:
    • Inserido com sucesso.
    • Falso: Falha na operação.

    Tipo de dados: Booliano
    ResultadoReservas.Bem-sucedidas.Reservável Sys_id do local de trabalho para o qual a reserva foi feita.

    Tipo de dados: Cadeia de caracteres

    Tabela: Local do local de trabalho [sn_wsd_core_workplace_location]
    SuccessfulReservas.Sucesso Sinalizador que indica se a operação associada foi bem-sucedida.
    Valores possíveis:
    • Verdadeiro: A operação foi bem-sucedida.
    • Falso: Falha na operação.

    Tipo de dados: Booliano
    Result.successfulReservations.sys_id Sys_id da reserva que foi criada.

    Tipo de dados: Cadeia de caracteres

    Tabela: Reserva do local de trabalho [sn_wsd_rsv_reservation]
    Result.successfulReservations.update Sinalizador que indica se a reserva foi atualizada com sucesso.
    Valores possíveis:
    • Verdadeiro: Atualizado com sucesso.
    • Falso: Não atualizado.

    Tipo de dados: Booliano
    Resultado.Reservas sem sucesso Lista de reservas malsucedidas.

    Tipo de dados: Matriz de objetos

    "unSuccessfulReservations": [
  {
    "cancelled": Boolean,
    "error": "String",
    "insert": Boolean
    "reservable": "String"
    "success": Boolean,
    "sys_id": "String",
    "updated": Boolean
  }
]
    result.unSuccessfulReservations.canceled Sinalizador que indica se a reserva foi cancelada com sucesso.
    Valores possíveis:
    • Verdadeiro: Cancelado com sucesso.
    • Falso: Não cancelado.

    Tipo de dados: Booliano
    ResultDeSuccessfulReservations.ERROR Mensagem de erro se houve um problema ao criar a reserva.

    Tipo de dados: Cadeia de caracteres
    result.unSuccessfulReservations.insert Sinalizador que indica se a reserva foi inserida com sucesso.
    Valores possíveis:
    • Inserido com sucesso.
    • Falso: Falha na operação.

    Tipo de dados: Booliano
    Reservas.Sem Sucesso.Reservável Sys_id do local de trabalho para o qual a reserva estava tentando ser feita.

    Tipo de dados: Cadeia de caracteres

    Tabela: Local do local de trabalho [sn_wsd_core_workplace_location]
    Reservas.Sem Sucesso.Sucesso.Sucesso Sinalizador que indica se a reserva foi criada com sucesso.
    Valores possíveis:
    • Verdadeiro: Criado com sucesso.
    • Falso: Falha na operação.

    Tipo de dados: Booliano
    UnSuccessfulReservations.sys_id Sys_id da reserva malsucedida.

    Sempre nulo.

    Tipo de dados: Cadeia de caracteres
    UnSuccessfulReservations.update Sinalizador que indica se a reserva foi atualizada com sucesso.
    Valores possíveis:
    • Verdadeiro: Atualizado com sucesso.
    • Falso: Não atualizado.

    Tipo de dados: Booliano

    Solicitação de curl

    O exemplo de código a seguir mostra como modificar o conteúdo de uma reserva múltipla existente.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/update/02000d4edb7650106c731dcd13961914" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
    \"reservables\":[
        { 
            \"sys_id\":\"fe1f744edb7650106c731dcd139619ca\" 
        }, 
        {
            \"sys_id\":\"02000d4edb7650106c731dcd13961914\"
        }
    ],
    \"reservable_module\":\"c31241cedb7650106c731dcd13961917\",
    \"subject\":\"Test 1\",
    \"start\":\"2022-05-27 13:00:00\",
    \"end\":\"2022-05-27 14:00:00\",
    \"requested_for\": \"workplace_user@example.com\"
}" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "parent": "98ccb4348723cd106342b846dabb359a",
    "success": true,
    "successfulReservations": [
      {
        "success": true,
        "updated": true,
        "cancelled": false,
        "sys_id": "6cccb4348723cd106342b846dabb359d",
        "error": null,
        "reservable": "5eafb44edb7650106c731dcd13961943"
      },
      {
        "success": true,
        "updated": true,
        "cancelled": false,
        "sys_id": "74af283c87ef8d106342b846dabb3592",
        "error": null,
        "reservable": "fe1f744edb7650106c731dcd139619ca"
      }
    ],
    "unSuccessfulReservations": []
  }
}

    Solicitação de curl

    O exemplo de código a seguir mostra como adicionar um local de trabalho a uma reserva múltipla existente.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/update/02000d4edb7650106c731dcd13961914" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
   \"reservables\":[
       { 
           \"sys_id\":\"fe1f744edb7650106c731dcd139619ca\",
           \"is_private\": false 
       }, 
       {
           \"sys_id\":\"5eafb44edb7650106c731dcd13961943\",
           \"is_private\": false
       },
    {
           \"sys_id\":\"c4308d4edb7650106c731dcd1396194c\",
           \"is_private\": false
       }
   ],
   \"reservable_module\":\"c31241cedb7650106c731dcd13961917\",
   \"subject\":\"Test 1\",
   \"start\":\"2022-05-27 13:00:00\",
   \"end\":\"2022-05-27 14:00:00\",
   \"requested_for\": \"workplace_user@example.com\"
}" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "parent": "98ccb4348723cd106342b846dabb359a",
    "success": true,
    "successfulReservations": [
      {
        "success": true,
        "updated": true,
        "cancelled": false,
        "sys_id": "6cccb4348723cd106342b846dabb359d",
        "error": null,
        "reservable": "5eafb44edb7650106c731dcd13961943"
      },
      {
        "success": true,
        "updated": true,
        "cancelled": false,
        "sys_id": "74af283c87ef8d106342b846dabb3592",
        "error": null,
        "reservable": "fe1f744edb7650106c731dcd139619ca"
      },
      {
        "success": true,
        "inserted": true,
        "sys_id": "9e6d78748723cd106342b846dabb35a5",
        "error": null,
        "reservable": "c4308d4edb7650106c731dcd1396194c"
      }
    ],
    "unSuccessfulReservations": []
  }
}

    Solicitação de curl

    O exemplo de código a seguir mostra como converter uma única reserva em uma reserva múltipla.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/update/02000d4edb7650106c731dcd13961914" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
   \"reservables\":[
       { 
           \"sys_id\":\"fe1f744edb7650106c731dcd139619ca\",
           \"is_private\": false
       }, 
       {
           \"sys_id\":\"5eafb44edb7650106c731dcd13961943\",
           \"is_private\": false
       }
   ],
   \"reservable_module\":\"c31241cedb7650106c731dcd13961917\",
   \"subject\":\"Test 1\",
   \"start\":\"2022-05-27 13:00:00\",
   \"end\":\"2022-05-27 14:00:00\",
   \"requested_for\": \"workplace_user@example.com\"
}" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "success": true,
    "parent": "98ccb4348723cd106342b846dabb359a",
    "successfulReservations": [
      {
        "success": true,
        "inserted": true,
        "sys_id": "6cccb4348723cd106342b846dabb359d",
        "error": null,
        "reservable": "5eafb44edb7650106c731dcd13961943"
      },
      {
        "success": true,
        "insert": false,
        "update": true,
        "cancel": false,
        "sys_id": "74af283c87ef8d106342b846dabb3592",
        "reservable": "fe1f744edb7650106c731dcd139619ca"
      }
    ],
    "unSuccessfulReservations": [],
    "error": null
  }
}

    Solicitação de curl

    O exemplo de código a seguir mostra como converter uma reserva múltipla em uma única reserva.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/update/02000d4edb7650106c731dcd13961914" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
   \"reservables\":[
       { 
           \"sys_id\":\"fe1f744edb7650106c731dcd139619ca\",
           \"is_private\": false
       }
   ],
   \"reservable_module\":\"c31241cedb7650106c731dcd13961917\",
   \"subject\":\"Test 1\",
   \"start\":\"2022-05-27 13:00:00\",
   \"end\":\"2022-05-27 14:00:00\",
   \"requested_for\": \"workplace_user@example.com\"
}" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "sys_id": "74af283c87ef8d106342b846dabb3592",
    "success": true,
    "successfulReservations": [
      {
        "success": true,
        "insert": false,
        "update": true,
        "cancel": false,
        "sys_id": "74af283c87ef8d106342b846dabb3592",
        "reservable": "fe1f744edb7650106c731dcd139619ca",
        "error": ""
      },
      {
        "success": true,
        "insert": false,
        "update": true,
        "cancel": true,
        "sys_id": "3caf283c87ef8d106342b846dabb3596",
        "reservable": "5eafb44edb7650106c731dcd13961943"
      }
    ],
    "unSuccessfulReservations": [],
    "error": null
  }
}

    Reserva múltipla de WSD - POST /api/sn_wsd_rsv/multi_reservation/add

    Cria reservas de local de trabalho para o mesmo horário em diferentes locais do local de trabalho.

    Formato de URL

    URL com controle de versão: /api/sn_wsd_rsv//multi_reservation/add

    URL padrão: /api/sn_wsd_rsv/multi_reservation/add

    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 13. 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 14. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 15. Parâmetros do corpo da solicitação
    Nome Descrição
    término Necessário se shifto parâmetro não foi passado. Hora de término solicitada da reserva.

    Tipo de dados: Cadeia de caracteres

    Formato: UTC ou hora local (aaaa-mm-dd hh:mm:ss)
    requested_for Sys_id ou endereço de e-mail do usuário para o qual a reserva está sendo feita.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    reserváveis Lista de detalhes sobre os reserváveis associados à reserva.

    Tipo de dados: Matriz de objetos

    "reservables": [
  {
    "is_private": Boolean,
    "sys_id": "String"
  }
]
    reservables.is_private Sinalizador que indica se a reserva é privada. Se for privada, a reserva não aparecerá para ninguém, exceto o proprietário.

    Para obter informações adicionais sobre essas configurações de privacidade, consulte Configurações de privacidade do local e impacto .

    Valores válidos:
    • Verdadeiro: A reserva é privada.
    • Falso: A reserva não é privada.

    Tipo de dados: Booliano

    Valor definido para privacidade nas propriedades do sistema.
    reservables.sys_id Sys_id do local no qual fazer as reservas.

    Tipo de dados: Cadeia de caracteres

    Tabela: Local do local de trabalho [sn_wsd_core_workplace_location]
    reservable_module Obrigatório. Sys_id do módulo reservável a ser associado à reserva. . módulo reservável define os itens do local de trabalho necessários para uma reserva.

    Tipo de dados: Cadeia de caracteres

    Tabela: Módulo reservável [sn_wsd_rsv_reservable_module]
    shift
    Sys_id do turno a ser associado à reserva. Se este parâmetro for passado, o endo parâmetro não é necessário.

    Para obter informações adicionais sobre reservas baseadas em turno, consulte Habilitar reserva baseada em turno .

    Tipo de dados: Cadeia de caracteres

    Tabela: Shift [sn_wsd_core_shift]
    início Obrigatório. Hora de início solicitada da reserva.

    Tipo de dados: Cadeia de caracteres

    Formato: UTC ou hora local (aaaa-mm-dd hh:mm:ss)
    assunto Obrigatório.
    Assunto da reunião associada à reserva.

    Tipo de dados: Cadeia de caracteres

    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 16. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da solicitação. Tipos compatíveis: application/json, application/xmlou, text/xml.

    Padrão: application/json
    Tipo de conteúdo Formato de dados do corpo da solicitação. Oferece suporte somente a application/json.
    Tabela 17. 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 18. Códigos de status
    Código do status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso.
    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 Retornar resultados da criação ou atualização de várias reservas.

    Tipo de dados: Objeto

    "result": {
  "parent": "String",
  "success": Boolean,
  "successfulReservations": [Array],
  "unSuccessfulReservations": [Array]
}
    resultado.primário Sys_id da reserva primária. Um primário pode ter uma ou mais reservas secundárias associadas a ele.

    Tipo de dados: Cadeia de caracteres
    resultado.sucesso Sinalizador que indica se a reserva foi criada com sucesso.
    Valores possíveis:
    • Verdadeiro: Criado com sucesso.
    • Falso: Falha na operação.

    Tipo de dados: Booliano
    Result.successfulReservations Lista de reservas que foram criadas com sucesso.

    Tipo de dados: Matriz de objetos

    "successfulReservations": [
  {
    "error": "String",
    "inserted": Boolean,
    "reservable": "String"
    "success": Boolean,
    "sys_id": "String"
  }
]
    Result.successfulReservations.ERROR Mensagem de erro se houve um problema ao criar a reserva.

    Tipo de dados: Cadeia de caracteres
    result.successfulReservations.inserted Sinalizador que indica se a reserva foi inserida com sucesso. Quando uma reserva é adicionada.
    Valores possíveis:
    • Inserido com sucesso.
    • Falso: Falha na operação.

    Tipo de dados: Booliano
    ResultadoReservas.Bem-sucedidas.Reservável Sys_id do local de trabalho para o qual a reserva foi feita.

    Tipo de dados: Cadeia de caracteres

    Tabela: Local do local de trabalho [sn_wsd_core_workplace_location]
    SuccessfulReservas.Sucesso Sinalizador que indica se a reserva foi criada com sucesso.
    Valores possíveis:
    • Verdadeiro: Criado com sucesso.
    • Falso: Falha na operação.

    Tipo de dados: Booliano
    Result.successfulReservations.sys_id Sys_id da reserva que foi criada.

    Tipo de dados: Cadeia de caracteres

    Tabela: Reserva do local de trabalho [sn_wsd_rsv_reservation]
    Resultado.Reservas sem sucesso Lista das reservas que não foram bem-sucedidas.

    Tipo de dados: Matriz de objetos

    "unSuccessfulReservations": [
  {
    "error": "String",
    "inserted": Boolean,
    "reservable": "String"
    "success": Boolean,
    "sys_id": "String"
  }
]
    ResultDeSuccessfulReservations.ERROR Mensagem de erro se houve um problema ao criar a reserva.

    Tipo de dados: Cadeia de caracteres
    result.unSuccessfulReservations.inserted Sinalizador que indica se a reserva foi inserida com sucesso.
    Valores possíveis:
    • Inserido com sucesso.
    • Falso: Falha na operação.

    Tipo de dados: Booliano
    Reservas.Sem Sucesso.Reservável Sys_id do local de trabalho para o qual a reserva estava tentando ser feita.

    Tipo de dados: Cadeia de caracteres

    Tabela: Local do local de trabalho [sn_wsd_core_workplace_location]
    Reservas.Sem Sucesso.Sucesso.Sucesso Sinalizador que indica se a reserva foi criada com sucesso.
    Valores possíveis:
    • Verdadeiro: Criado com sucesso.
    • Falso: Falha na operação.

    Tipo de dados: Booliano
    UnSuccessfulReservations.sys_id Sys_id da reserva malsucedida.

    Sempre nulo.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    Este exemplo de código mostra como reservar dois locais de trabalho diferentes para a mesma reserva.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/add" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
    \"reservable_module\": \"c31241cedb7650106c731dcd13961917\",
    \"subject\": \"Test-123\",
    \"reservation_purpose\": \"meeting\",
    \"timezone\": \"US/Pacific\",
    \"requested_for\": \"6816f79cc0a8016401c5a33be04be441\",
    \"reservables\": [
        {
            \"sys_id\": \"fe1f744edb7650106c731dcd139619ca\",
            \"is_private\": false
        },
        {
            \"sys_id\": \"d1208d4edb7650106c731dcd1396194a\",
            \"is_private\": false
        }
    ],
    \"start\": \"2023-01-12T11:30:00Z\",
    \"end\": \"2023-01-12T12:30:00Z\",
    \"reservation_type\": \"space\"
}" \
--user "username":"password"

    Resultados de retorno:

    {
  "result": {
    "success": true,
    "parent": "08e8a18687586550cfaa99b73cbb354f",
    "successfulReservations": [
      {
        "success": true,
        "inserted": true,
        "sys_id": "44e8a18687586550cfaa99b73cbb3552",
        "error": null,
        "reservable": "fe1f744edb7650106c731dcd139619ca"
      },
      {
        "success": true,
        "inserted": true,
        "sys_id": "04e8a18687586550cfaa99b73cbb3555",
        "error": null,
        "reservable": "d1208d4edb7650106c731dcd1396194a"
      }
    ],
    "unSuccessfulReservations": []
  }
}