API de Matrículas
Como criar, atualizar e cancelar matrículas via API Thinkr
Última revisão: Outubro de 2025 • Tempo estimado de leitura: 5 minutos
A API da Thinkr permite automatizar matrículas: criar, atualizar vencimentos ou cancelar acessos. Este artigo explica como utilizar esses recursos.
Documentação prática: Você tem todos os detalhes na
Collection do Postman disponível clicando aqui
.
1. Autenticação
Use as mesmas chaves (Key e Secret) configuradas em Configurações → Chaves API.
2. Criando matrícula
POST https://SEU_DOMINIO_THINKR/api/v1/matriculas
Campos mais comuns:
cpf— CPF do alunocurso_id,pacote_idouproduto_idstatus— use Matriculado
Exemplo
curl --location --request POST 'https://SEU_DOMINIO/api/v1/matriculas' \
--header 'key: SUA_KEY' \
--header 'secret: SEU_SECRET' \
--data-urlencode 'Matricula[0][cpf]=99999999999' \
--data-urlencode 'Matricula[0][curso_id]=100' \
--data-urlencode 'Matricula[0][status]=Matriculado'
3. Atualizando matrícula
Para definir data de expiração:
curl --location --request PUT 'https://SEU_DOMINIO/api/v1/matriculas' \
--header 'key: SUA_KEY' \
--header 'secret: SEU_SECRET' \
--data-urlencode 'Matricula[0][cpf]=99999999999' \
--data-urlencode 'Matricula[0][curso_id]=100' \
--data-urlencode 'Matricula[0][data_expiracao]=2025-12-31'
4. Cancelando matrícula
curl --location --request PUT 'https://SEU_DOMINIO/api/v1/matriculas' \
--header 'key: SUA_KEY' \
--header 'secret: SEU_SECRET' \
--data-urlencode 'Matricula[0][cpf]=99999999999' \
--data-urlencode 'Matricula[0][curso_id]=100' \
--data-urlencode 'Matricula[0][status]=Cancelada'
5. Observações importantes
- Para pacotes e produtos, substitua
curso_idporpacote_idouproduto_id. - Sempre valide a resposta da API para confirmar o sucesso.
- Registre internamente quais sistemas estão consumindo os endpoints de matrículas.
