Alteração de Status
O objetivo principal desse webhook é fornecer uma notificação em tempo real quando ocorrer a desabilitação de um cadastro. Isso permite que a instituição ou o sistema acompanhe as mudanças de status dos usuários.
📈 Tipo de dados do payload:
Detalhes do Evento
- Nome: Nome do evento em formato de texto.
- Slug: Identificador único do evento em formato de texto.
- Enviar em: Data e hora do evento no formato “yyyy-MM-dd HH:mm:ss”.
- Ação: Ação associada ao evento em formato de texto.
Dados do Usuário:
- ID: Identificador numérico do usuário.
- Nome: Nome do usuário em formato de texto.
- Email: Endereço de email do usuário em formato de texto.
- Instituição:
- ID: Identificador numérico da instituição.
- Escolas:
- ID: Identificador numérico da escola.
- ID da Função: Identificador numérico da função do usuário na escola.
- Criado em: Data e hora de criação no formato “dd/MM/yyyy HH:mm:ss”.
- Atualizado em: Data e hora de atualização no formato “dd/MM/yyyy HH:mm:ss”.
- Escolas:
- ID: Identificador numérico da instituição.
- Instituição:
- Apelido: Valor nulo (null) ou apelido do usuário em formato de texto.
- CPF: Número de CPF do usuário em formato de texto.
- UUID: Valor nulo (null) ou identificador único universal do usuário em formato de texto.
📈 Dados do evento:
Nome: Membros - Edição de dados de usuário
Slug: members.updated
Enviar em: 2023-07-03 12:56:48
Ação: atualização
Ação para disparar o evento:
O evento será acionado quando o status de um usuário for alterado, por exemplo, de “ativo” para “inativo”.
Payload/Exemplo de resposta:
O sistema deve responder com um código HTTP 200 OK se a operação for bem-sucedida. Se houver algum erro, o sistema deve responder com um código HTTP 4xx ou 5xx e uma mensagem de erro.
🔒 Segurança:
Certifique-se de que a URL de destino esteja correta antes de começar a enviar payloads. Verifique se os parâmetros enviados estão corretos e completos. Certifique-se de que os destinatários do webhook estejam corretos e sejam válidos. Registre e monitore todas as chamadas de webhook para fins de auditoria e rastreamento de problemas.
⚠️ Códigos de Erro:
O sistema deve responder com um código HTTP 200 OK se a operação for bem-sucedida. Se houver algum erro, o sistema deve responder com um código HTTP 4xx ou 5xx e uma mensagem de erro.
💬 Glossário:
- Payload: dados que são enviados para o webhook.
- Slug: um identificador único para o evento.
- Autenticação: processo de verificação da identidade do remetente de uma solicitação.