{ "Authorization": "Bearer SEU_TOKEN", "Content-Type": "application/json" }

Body JSON:

{ "user_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef", "class_id": "f9e8d7c6-b5a4-3210-9876-543210fedcba", "status": "active" }

Exemplo em bash (curl):

bash curl -X POST https://api.toolzz.com.br/v1/enrollments -H 'Authorization: Bearer SEU_TOKEN' -H 'Content-Type': 'application/json' -d '{ "user_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef", "class_id": "f9e8d7c6-b5a4-3210-9876-543210fedcba", "status": "active" }'

Exemplo em javascript (fetch):

javascript fetch('https://api.toolzz.com.br/v1/enrollments', { method: 'POST', headers: { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify({ user_id: 'a1b2c3d4-e5f6-7890-1234-567890abcdef', class_id: 'f9e8d7c6-b5a4-3210-9876-543210fedcba', status: 'active' }) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error));

Exemplo em python (requests):

python import requests

url = 'https://api.toolzz.com.br/v1/enrollments' headers = { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } data = { 'user_id': 'a1b2c3d4-e5f6-7890-1234-567890abcdef', 'class_id': 'f9e8d7c6-b5a4-3210-9876-543210fedcba', 'status': 'active' }

response = requests.post(url, headers=headers, json=data)

print(response.json())

Parâmetros:

Response JSON de exemplo:

{ "id": "01234567-89ab-cdef-0123-456789abcdef", "user_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef", "class_id": "f9e8d7c6-b5a4-3210-9876-543210fedcba", "status": "active", "created_at": "2024-10-27T10:00:00Z", "updated_at": "2024-10-27T10:00:00Z" }

Webhooks

Para monitorar as matrículas, você pode configurar um webhook para o evento enrollment.created. Quando uma nova matrícula é criada, a API da Toolzz enviará uma notificação para a URL configurada, contendo os dados da matrícula.

Configuração do webhook:

1. Acesse a seção 'Webhooks' no painel de administração da Toolzz.
2. Clique em 'Criar Webhook'.
3. Defina a URL para receber as notificações.
4. Selecione o evento enrollment.created.
5. Salve o webhook.

Payload de exemplo:

{ "event": "enrollment.created", "data": { "id": "01234567-89ab-cdef-0123-456789abcdef", "user_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef", "class_id": "f9e8d7c6-b5a4-3210-9876-543210fedcba", "status": "active", "created_at": "2024-10-27T10:00:00Z", "updated_at": "2024-10-27T10:00:00Z" } }

Testando

Para validar a integração, você pode utilizar a API para matricular um aluno em uma turma e verificar se a matrícula foi criada corretamente na plataforma Toolzz LXP. Você também pode verificar se o webhook está sendo chamado e se os dados da matrícula estão sendo enviados corretamente.

Erros comuns

• 400 Bad Request: Erro nos dados enviados. Verifique se os parâmetros user_id e class_id estão corretos e se o formato dos dados está correto.
• 401 Unauthorized: Token inválido ou ausente. Verifique se o token está correto e se você está incluindo-o no header de autorização.
• 404 Not Found: Usuário ou turma não encontrados. Verifique se os IDs do usuário e da turma existem na plataforma.
• 500 Internal Server Error: Erro interno no servidor. Entre em contato com o suporte da Toolzz.

Conclusão

A automatização da matrícula de alunos é um passo importante para a modernização da gestão educacional. Ao integrar sistemas e utilizar a API da Toolzz, as empresas podem otimizar processos, reduzir erros e liberar recursos para atividades mais estratégicas. A combinação de uma plataforma robusta como a Toolzz LXP, com a flexibilidade da sua API, oferece uma solução completa para as necessidades de educação corporativa.

Com a Toolzz AI, você pode ir além da automação da matrícula e criar um assistente virtual que gerencia todo o processo de aprendizagem, desde a inscrição até o acompanhamento do desempenho. Quer saber mais sobre como a Toolzz pode te ajudar? Conheça a Toolzz AI e descubra o futuro da educação corporativa!