API de Alunos
Como cadastrar e editar alunos via API da Thinkr
Última revisão: Outubro de 2025 • Tempo estimado de leitura: 5 minutos
Com a API da Thinkr, você pode cadastrar e editar alunos automaticamente a partir de sistemas externos. Este artigo explica a autenticação, os campos suportados e exemplos de chamadas.
Documentação prática: Você tem todos os detalhes na
Collection do Postman disponível clicando aqui
.
1. Autenticação e cabeçalho
Envie estes cabeçalhos em todas as requisições:
key: SUA_KEY_AQUI
secret: SEU_SECRET_AQUI
Content-Type: application/x-www-form-urlencoded
2. Campos aceitos
A API aceita até 16 campos diferentes de aluno. Exemplos:
nome, email, rg, data_nascimento, logradouro, numero, complemento,
bairro, cidade, estado, pais, cep, telefone1, data_registro, password
Atenção:
- Informe sempre o telefone com código do país (ex.: +5511912345678).
- Se seu ambiente usa cadastro em 1 etapa, são obrigatórios: nome, email, cpf, data_nascimento, telefone1, password.
- No cadastro em 2 etapas, apenas: nome, email e password.
3. Endpoints
Cadastro (POST) e edição (PUT):
https://SEU_DOMINIO_THINKR/api/v1/alunos/{CPF_DO_ALUNO}
4. Exemplos práticos
Cadastrar aluno (cadastro em 2 etapas)
curl --location --request POST 'https://SEU_DOMINIO/api/v1/alunos/CPF' \
--header 'key: SUA_KEY' \
--header 'secret: SEU_SECRET' \
--data-urlencode 'nome=Fulano da Silva' \
--data-urlencode '[email protected]' \
--data-urlencode 'password=senha@123'
Editar aluno
curl --location --request PUT 'https://SEU_DOMINIO/api/v1/alunos/CPF' \
--header 'key: SUA_KEY' \
--header 'secret: SEU_SECRET' \
--data-urlencode 'nome=Fulano Atualizado' \
--data-urlencode '[email protected]'
5. Dicas finais
- Teste as requisições antes de usar em produção.
- Documente quais sistemas utilizam cada chave.
- Em caso de erro, envie ao suporte o endpoint, cabeçalhos e corpo da requisição.
