Agendar Videconferência

Cria um agendamento para a solicitação informada e na data e hora informada.

agendar-videoconferencia

POST <base_url>/videoconferencia-api/agendar-videoconferencia

Headers

Name	Type	Description
HMAC-Authentication*	String	Resultado do cálculo HMAC
Content-type*	String	application/json

Request Body

Name	Type	Description
dataHoraAgendamento*	String	Data e hora do agendamento
protocolo*	String	Número do Protocolo
senha*	String	Senha de emissão do Certificado Digital

200: OK

{
    "message": "Agendamento atualizado com sucesso.",
    "dataHoraAgendada": "2021-10-18 09:00:00"
}

403: Forbidden

500: Internal Server Error

O conteúdo do body deverá estar em formato JSON.

O body deverá conter os seguintes itens:

• dataHoraAgendamento: Data e hora do agendamento no formato ano-mês-dia hora:minuto. Os horários disponíveis são retornados no serviço horarios-disponiveis-videoconferencia. Exemplo: 2021-10-18 09:30

• protocolo: Número do Protocolo. O número é retornado no serviço nova-solicitacao.

• senha: A mesma enviada no serviço nova-solicitacao.

Regras de utilização da chave senha

1. Se no serviço nova-solicitacao foi enviada a chave senha

   • O mesmo valor deverá ser informado neste serviço, também na chave senha.

   Exemplo:

   // Requisição no serviço nova-solicitacao
   {
     "senha": "abc123"
   }
   
   // Requisição neste serviço
   {
     "senha": "abc123"
   }

2. Se no serviço nova-solicitacao foi enviada a chave senhaTemp

   • O valor informado em senhaTemp deverá ser enviado neste serviço na chave senha.

   Exemplo:

   // Requisição no serviço nova-solicitacao
   {
     "senhaTemp": "xyz789"
   }
   
   // Requisição neste serviço
   {
     "senha": "xyz789"
   }

Exemplo do body

Exemplo do body em formato JSON

{
    "dataHoraAgendamento": "2021-10-18 09:00",
    "protocolo": "22714-25",
    "senha": "SoLuTI@123"
}

Exemplo do body em PHP

Código de Exemplo

PHP

<?php
require_once 'HTTP/Request2.php';

$base_url = 'https://arsolutihom.acsoluti.com.br';
$uri = "{$base_url}/videoconferencia-api/agendar-videoconferencia";
$method = 'POST';
$hmacVersion = 1;
$clientId = 0;

$mensagem = array(
    'dataHoraAgendamento' => '2021-10-18 09:00',
    'protocolo' => '22714-25',
    'senha' => 'SoLuTI@123'
);

$m = json_encode($mensagem);

$ds = $method . $uri . $m;

$key = 'CHAVESECRETAAPI';
$nonce = time();
$hkey = $nonce . $key;
$hmac = hash('sha256', hash('sha256', $hkey) . hash('sha256', $hkey . $ds));

$headers = [
    'Content-type' => 'application/json',
    'HMAC-Authentication' => $hmacVersion . ':' . $clientId . ':' . $nonce . ':' . $hmac
];

$request = new HTTP_Request2();
$request->setUrl($uri);
$request->setMethod(HTTP_Request2::METHOD_POST);
$request->setHeader($headers);
$request->setBody($m);

$response = $request->send();

echo $response->getBody();

Resposta esperada - HTTP Status Code 200

Resposta em formato JSON

{
    "message": "Agendamento atualizado com sucesso.",
    "dataHoraAgendada": "2021-10-18 09:00:00"
}

Nesse momento de forma automática o Sistema de AR irá enviar um e-mail para o Cliente com link de acesso a sala da Videoconferência.

Caso o Cliente decida alterar a data e hora do agendamento, faça uma nova requisição a esse serviço enviando a nova data e hora.

Descrição dos campos

• message: Mensagem de confirmação do agendamento na data e hora informada.

• dataHoraAgendada: Data e Hora do agendamento.

Importar Documentos