Authorization: Bearer SEU_TOKEN Content-Type: application/json

Body JSON de Exemplo:

{ "name": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "role": "aluno" }

curl:

bash curl -X POST https://api.toolzz.dev/v1/users -H 'Authorization: Bearer SEU_TOKEN' -H 'Content-Type: application/json' -d '{"name": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "role": "aluno"}'

JavaScript (fetch):

javascript fetch('https://api.toolzz.dev/v1/users', { method: 'POST', headers: { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify({ "name": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "role": "aluno" }) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Erro:', error));

Python (requests):

python import requests import json

url = 'https://api.toolzz.dev/v1/users' headers = { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } data = { 'name': 'João da Silva', 'email': '[email protected]', 'cpf': '123.456.789-00', 'role': 'aluno' }

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

print(response.json())

Parâmetros:

Response JSON de Exemplo:

{ "id": "123e4567-e89b-12d3-a456-426614174000", "name": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "role": "aluno", "created_at": "2024-10-27T10:00:00Z" }

2. Matricular Alunos em uma Turma

Authorization: Bearer SEU_TOKEN Content-Type: application/json

Body JSON de Exemplo:

{ "user_id": "123e4567-e89b-12d3-a456-426614174000", "class_id": "a7b8c9d0-e1f2-3456-7890-1234567890ab" }

curl:

bash curl -X POST https://api.toolzz.dev/v1/enrollments -H 'Authorization: Bearer SEU_TOKEN' -H 'Content-Type: application/json' -d '{"user_id": "123e4567-e89b-12d3-a456-426614174000", "class_id": "a7b8c9d0-e1f2-3456-7890-1234567890ab"}'

JavaScript (fetch):

javascript fetch('https://api.toolzz.dev/v1/enrollments', { method: 'POST', headers: { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify({ "user_id": "123e4567-e89b-12d3-a456-426614174000", "class_id": "a7b8c9d0-e1f2-3456-7890-1234567890ab" }) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Erro:', error));

Python (requests):

python import requests import json

url = 'https://api.toolzz.dev/v1/enrollments' headers = { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } data = { 'user_id': '123e4567-e89b-12d3-a456-426614174000', 'class_id': 'a7b8c9d0-e1f2-3456-7890-1234567890ab' }

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

print(response.json())

Parâmetros:

Response JSON de Exemplo:

{ "enrollment_id": "f4g5h6i7-j8k9-l0m1-n2o3-4567890abcdef", "user_id": "123e4567-e89b-12d3-a456-426614174000", "class_id": "a7b8c9d0-e1f2-3456-7890-1234567890ab", "enrolled_at": "2024-10-27T10:05:00Z" }

Webhooks

Embora este tutorial foque na matrícula, o webhook Curso Concluído pode ser útil para acionar processos adicionais após a conclusão de um curso, como a emissão de certificados ou a atribuição de novos cursos. Configure o webhook no painel da Toolzz LMS, especificando a URL para onde as notificações serão enviadas.

Testando

Após implementar a automação, teste cuidadosamente a integração. Verifique se os usuários são criados corretamente (se aplicável) e se a matrícula na turma é realizada com sucesso. Consulte o LMS para confirmar a inscrição e verifique se o usuário tem acesso ao conteúdo do curso.

Erros Comuns

• Erro 400 - Bad Request: Indica que a requisição está malformada. Verifique se o JSON está correto e se todos os parâmetros obrigatórios estão presentes.
• Erro 401 - Unauthorized: Indica que o token de autenticação é inválido ou está faltando. Verifique se o token está correto e se tem as permissões necessárias.
• Erro 404 - Not Found: Indica que o usuário ou a turma não foram encontrados. Verifique se os IDs estão corretos.
• Erro 500 - Internal Server Error: Indica um erro no servidor da Toolzz. Entre em contato com o suporte.

Conclusão

A automatização de matrículas na Toolzz LMS através da API oferece uma maneira eficiente de agilizar processos e reduzir a carga administrativa. Ao entender os erros comuns e seguir as melhores práticas, você pode garantir uma integração bem-sucedida e aproveitar ao máximo os benefícios da plataforma. Lembre-se de testar cuidadosamente a integração e monitorar o sistema para identificar e corrigir quaisquer problemas que possam surgir.

E se em vez de chamar a API manualmente, um agente de IA fizesse isso por você? Com a Toolzz AI, crie um agente que matricula alunos, consulta notas e gera relatórios — tudo por WhatsApp. Já imaginou o gestor perguntar pelo WhatsApp: 'Matricula o João no curso de vendas' e o agente executar na hora? Conheça a Toolzz AI.