Documentação da API - Sie Edtech
// Primeiros Passos
Considerações
- Para requisições aos endpoints, sempre use o protocolo "HTTPS"
- Todos os resultados são servidos somente em
JSON
- Para ter acesso a métodos privados, é necessário um
token (contate nossa equipe de atendimento)
- Nem todos os métodos podem estar disponíveis para você
token (contate nossa equipe de atendimento)
Especificações Padrão
JSONtoken (contate nossa equipe de atendimento)token (contate nossa equipe de atendimento)| URL Base da API em Sandbox: | https://sandbox.sie.com.br/ |
|---|---|
| URL Base da API em Produção: | https://www.iped.com.br/ |
| Método de Requisição: | POST |
| Envio dos Parâmetros: | FORM DATA |
| Tipo de Dados Retornado: | JSON |
| Objetos Retornados: |
STATE 1 (em caso de sucesso) ou 0 (em caso de erro)ERROR em caso de erro (STATE 0), isto será uma mensagem literalSUCCESS em caso de sucesso (STATE 1), isto será uma mensagem literal
|
Versão da API
| Versão Padrão: | v1 |
|---|---|
| Nova Versão: | v2 |
| Como alternar a versão: | Envie o parâmetro api_version nas suas chamadas. Exemplo: api_version=2 |
| Principais mudanças da nova versão: |
|
Em modo Sandbox
| URL Base da API: | https://sandbox.sie.com.br/ |
|---|---|
| Ambiente Admin: | https://sandbox.sie.com.br/admin |
| Observações: |
|
FAQ - Perguntas e Respostas
| Pergunta: | Como faço para cadastrar uma pessoa e já liberar um curso em uma única chamada? |
|---|---|
| Resposta: | https://www.sie.com.br/api/doc/#user/set-registration |
| Pergunta: | Como listar os cursos com foto, titulo, descrição, etc? |
| Resposta: | https://www.sie.com.br/api/doc/#course/get-courses |
| Pergunta: | Como mostrar mais detalhes de um único curso? Para utilizar em uma tela de compra ou tela de detalhes do curso, por exemplo? |
| Resposta: | https://www.sie.com.br/api/doc/#course/get-details |
| Pergunta: | Como listar apenas os cursos em andamento, cursos que uma pessoa já iniciou? |
| Resposta: | https://www.sie.com.br/api/doc/#course/get-inprogress |
| Pergunta: | Como obter uma URL que abra direto o painel principal (AVA)? Para que eu possa utilizar dentro do meu site, sem que a pessoa precise se logar no site de vocês? |
| Resposta: | https://www.sie.com.br/api/doc/#user/get-logged-urlResultado: Vamos logar a pessoa no painel principal, personalizado com seu logo, sem que você precise fazer mais nada. Nesse ambiente já vão ter telas de cursos em andamento, tela para emitir certificado, etc. |
| Pergunta: | Como obter uma URL que abra direto a sala de aula, sem passar pelo painel principal (AVA)? Para que eu possa utilizar dentro do meu próprio painel, sem que a pessoa precise se logar no site de vocês? |
| Resposta: | https://www.sie.com.br/api/doc/#course/get-environmentResultado: Vamos logar a pessoa direto na sala de aula do curso, sem o painel principal. Você vai precisar utilizar as outras APIs para criar seu próprio painel com cursos em andamento, tela para emitir certificado, etc. |
Utilidade Geral
Obter última versão do App
Retorna as últimas versões de cada App pra cada plataforma (Android e iOS).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/app/get-versions |
| Objetos retornados: |
Version_Android a última versão do app Cursos iPED para AndroidVersion_IOS a última versão do app Cursos iPED para iOSVersion_Android_MeusCursos a última versão do app Meus Cursos para AndroidVersion_IOS_MeusCursos a última versão do app Meus Cursos para iOS |
| Exemplo de retorno (JSON): |
{
"Version_Android": "3.6.1",
"Version_IOS": "3.5.0",
"Version_Android_MeusCursos": "3.7.2",
"Version_IOS_MeusCursos": "3.6.0"
}
|
Obter informação de CEP
Ao informar um CEP brasileiro, retorna o endereço completo.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/app/get-postalcode |
| Parâmetros: |
token opcional - Token de acesso a APIpostalcode o CEP brasileiro (o formato pode ser "12345-789" ou "12345789")
|
| Objetos retornados: |
ADDRESS utilize este objeto para manusear o resultado
|
| Exemplo de retorno (JSON): |
{
"ADDRESS": {
"address_street": "Nome da Rua",
"address_neighborhood": "Nome do Bairro",
"address_postalcode": "12345678",
"address_city": "Nome da Cidade",
"address_state": {
"state_id": 26,
"state_uf": "SP",
"state_name": "São Paulo"
}
}
}
|
Lista de Países
Versão em Português (JSON):
Versão em Inglês (JSON)
Versão em Espanhol (JSON):
Lista de Estados
Versão em Português (JSON):
Lista de Áreas de Atuação
Versão em Português (JSON):
Lista de Escolaridades
Versão em Português (JSON):
Lista de Regras de acesso
Versão em Português (JSON):
Login do Usuário
Login
Quando informado credenciais corretas, retorna a URL de acesso à sala de aula (AVA).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/login |
| Parâmetros: |
token opcional - Token de acesso a APIuser_email E-mail do Usuário ou CPFuser_password Senha do Usuárioplatform opcional - "1" para Android ou "2" para iOS (para uso apenas no App)user_registerid opcional - o ID de registro para GCM/APNS (para uso apenas no App)device_token opcional - o token do dispositivo para GCM/APNS (para uso apenas no App)
|
| Objetos retornados: |
USER_ID o ID do UsuárioUSER_TOKEN o Token Privado do Usuário (isto será usado para métodos de remoção, por exemplo)URL a URL para acesso à sala de aula (em caso de utilização em Web Apps)
|
| Exemplo de retorno (JSON): |
{
...
"USER_ID": 1,
"USER_TOKEN": "82e47251b78187e0acbacf185ec",
"USER_TYPE": 3,
"USER_COMPANY": {
"company_id": 1,
"company_name": "Nome da Empresa",
"company_url": "https://www.sie.com.br/url-da-empresa",
"company_logo": "https://...url-da-imagem",
"company_header_color": "#ffffff",
"company_categories_id": "",
"company_resources": [
"aulas",
"cursos",
"metas",
"biblioteca",
...
]
},
// Informações da IA para exibição no site.
"IA_INFO": {
"name": "Lina",
"image": "https://www.iped.com.br/_img/ia/1/imagem.jpg",
//link e text são propriedades para compra da IA, só aparecem caso o usuário não tenha IA habilitada.
"link": "https://www.iped.com.br/comprar/0?tipo=3&comprar_ia=1&mensal=1&user_id=396946&user_token=07f97e68e9bfa9d4a2b3333c745a0bc09573f5f6",
"text": "Adquirir por R$ 29,90"
}
...
}
Nota 1: Nota 2: |
Recuperar senha
Quando informado o e-mail ou CPF de cadastro, é enviado um e-mail de recuperação de senha para o usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/recovery |
| Parâmetros: |
user_email E-mail do Usuário ou CPF
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Enviamos as instruções para o seu e-mail: [email protected]."
}
|
Cadastro
Efetua o cadastro de um novo usuário. Retorna a URL de acesso à sala de aula.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/signup |
| Parâmetros: |
token opcional - Token de acesso a APIuser_name Nome Completo do Usuário (incluindo sobrenome)user_email E-mail do Usuáriouser_cpf CPF do Usuário (para brasileiros) ou Documento de Identificação (para estrangeiros)user_password Senha do Usuáriouser_country País do Usuário - valor inteiro (veja a lista) - padrão = 34 (Brasil)user_info opcional - Informação Extra do Usuário (um campo extra para informar qualquer informação extra sobre o usuário, como um número de registro interno, será exibido nos relatórios do 'Sie Edtech')user_occupation opcional - Área de Atuação do Usuário (veja a lista)platform opcional - "1" para Android ou "2" para iOS (para uso apenas no App)user_registerid opcional - o ID de registro para GCM/APNS (para uso apenas no App)device_token opcional - o token do dispositivo para GCM/APNS (para uso apenas no App)
|
| Objetos retornados: |
USER_ID o ID do UsuárioUSER_TOKEN o Token Privado do Usuário (isto será usado para métodos de remoção, por exemplo)URL a URL para acesso à sala de aula (em caso de utilização em Web Apps)
|
| Exemplo de retorno (JSON): |
{
...
"USER_ID": 1,
"USER_TOKEN": "82e47251b78187e0acbacf185ec",
"USER_TYPE": 3,
"USER_COMPANY": {
"company_id": 1,
"company_name": "Nome da Empresa",
"company_url": "https://www.sie.com.br/url-da-empresa",
"company_logo": "https://...url-da-imagem",
"company_header_color": "#ffffff",
"company_categories_id": "",
"company_resources": [
"aulas",
"cursos",
"metas",
"biblioteca",
...
]
}
...
}
Nota 1: Nota 2: |
Dados do Usuário
Obter perfil do usuário
Retorna dados principais do perfil de um usuário cadastrado (nome, email, foto de perfil, etc.).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/get-profile |
| Parâmetros: |
token Token de acesso a APIuser_id ID do Usuáriouser_token Token Privado do Usuário (logado)
|
| Objetos retornados: |
PROFILE em caso de sucesso, utilize este objeto para manusear os dados
|
| Exemplo de retorno (JSON): |
{
"PROFILE": {
"user_id": 1,
"user_type": 2,
"user_name": "Jonas Sampaio",
"user_first_name": "Jonas",
"user_email": "john@sie.com.br",
"user_image": "https://../url-da-imagem",
"user_image_small": "https://../url-da-imagem",
"user_cpf": "123.456.789-01",
"user_address": {
"address_street": "Nome da Rua",
"address_neighborhood": "Nome do Bairro",
"address_postalcode": "12345678",
"address_city": "Nome da Cidade",
"address_state": {
"state_id": 26,
"state_uf": "SP",
"state_name": "São Paulo"
}
},
"user_ranking": {
"user_points": {
"total": 10000,
"month": 2000
},
"user_level": {
"level_name": "Gran Mestre",
"level_image": "https://../url-da-imagem"
}
},
"user_dashboard": {
"dashboard_grade": "7.80",
"dashboard_score": 60,
"dashboard_colaborations": 70,
"dashboard_reflections": 10,
"dashboard_orientations": 6,
"dashboard_rating_total": 15,
"dashboard_rating_average": 4.50,
"dashboard_courses_inprogress": 2,
"dashboard_courses_completed": 3,
"dashboard_courses_total": 5,
"dashboard_badges": [
{
"badge_id": 4,
"badge_quantity": 1,
"badge_date": "2020-09-23 13:45:46",
"badge_title": "Aluno comprometido",
"badge_image": "https://...url-da-imagem"
},
...
],
"dashboard_profile": {
"main_area": {
"area_id": 2,
"area_name": "Administração",
"total_started_courses": 40
},
"secondary_area": {
"area_id": 25,
"area_name": "Cotidiano",
"total_started_courses": 20
},
"completed_courses_by_area": [
{
"area_id": 1,
"area_name": "3D e Games",
"total_completed_courses": 3
},
...
],
"last_course_completed": {
"course_id": 1,
"course_title": "Título do Curso",
"course_completed_date": "2020-06-18 08:14:26",
"course_completed_time": {
"time_in_seconds": 7200
}
},
"average_time_to_complete_course": {
"time_in_seconds": 1075474
},
"average_time_to_start_new_course": {
"time_in_seconds": 777746
},
"last_trail_completed": {
"trail_id": 1,
"trail_title": "Título da Trilha"
}
}
}
}
}
Nota: |
Atualizar perfil do usuário
Efetua atualização nos dados cadastrais de um usuário (foto de perfil, endereço, etc.).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/set-profile |
| Parâmetros: |
token Token de acesso a APIuser_id ID do Usuáriouser_token Token Privado do Usuário (logado)user_name opcional - Nome do Usuário (necessário sobrenome)user_email opcional - E-mail do Usuáriouser_cpf opcional - CPF do Usuário (para brasileiros) ou Documento de Identificação (para estrangeiros)user_photo opcional - Foto do Usuário (imagem/jpeg codificada com base64)user_address opcional - Endereço Completo (incluindo número)user_neighborhood opcional - Bairrouser_city opcional - Cidadeuser_state opcional - ID do Estado (veja a lista)user_postalcode opcional - CEPuser_cellphone opcional - Celular (informar no formato (99)99999-9999)user_genre opcional - Sexo (use "1" para masculino, "0" para feminino e "2" para outros)user_theme opcional - Tema do Ambiente da Sala de Aula (use "1" para claro/light, "2" para escuro/dark)user_birthday opcional - Data de Nascimento (informar no formato YYYY-MM-DD)user_education opcional - Escolaridade (ver valores em Lista de Escolaridades)user_occupation_area opcional - Área de atuação (ver valores em Lista de Categorias de Cursos)user_profession opcional - Profissão (ver valores em Lista de Profissões)user_professional_position opcional - Cargo do usuário
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Perfil atualizado com sucesso!"
}
|
Atualizar perfis de múltiplos usuários
Efetua atualização nos dados cadastrais de múltiplos usuários (foto de perfil, endereço, etc.).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/set-profiles |
| Parâmetros: |
token Token de acesso a APIusers JSON contendo a lista de usuários e atributos (disponível todos os campos do set-profile, veja exemplo abaixo). Limite máximo de 30 usuários.
|
| Exemplo de JSON: |
[
{
"user_id": "12345",
"user_token": "tokenPrivado123",
"user_name": "João Silva",
"user_email": "[email protected]",
"user_cpf": "123.456.789-00",
"user_address": "Rua das Flores, 123",
"user_neighborhood": "Centro",
"user_city": "São Paulo",
"user_state": "SP",
"user_postalcode": "01001-000",
"user_cellphone": "(11)91234-5678",
},
{
"user_id": "67890",
"user_token": "tokenPrivado456",
"user_name": "Maria Oliveira",
"user_education": "Pós-graduação",
"user_occupation_area": "Marketing e Comunicação",
"user_profession": "Especialista em Marketing Digital",
"user_professional_position": "Gerente de Projetos"
},
{
"user_id": "11223",
"user_token": "tokenPrivado789",
"user_professional_position": "Supervisor de Operações"
}
]
|
| Objetos retornados: |
STATE 1 Todos os dados foram atualizados com sucesso
STATE 0 Todos ou alguns usuários não foram atualizados (Acompanha mensagem de erro)
errors Em caso de erro, mostrará todos os usuários que não foram atualizados (Key será o id do usuário)
users Em caso de sucesso, mostrará todos os usuários que foram atualizados (Key será o id do usuário)
|
| Exemplo de retorno (JSON): |
{
"STATE": 0,
"errors": {
"123456": "Parâmetro user_token inválido."
},
"users": {
"321654": "Perfil editado com sucesso."
}
}
|
Obter preferências do usuário
Retorna dados das preferências salvas do usuário logado.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/get-preference |
| Parâmetros: |
token Token de acesso a APIuser_id ID do Usuáriouser_token Token Privado do Usuário (logado)
|
| Objetos retornados: |
PREFERENCE em caso de sucesso, utilize este objeto para manusear os dados
|
| Exemplo de retorno (JSON): |
{
"PREFERENCE": {
"user_id": 123456,
"user_language": "pt",
"user_course_assistant": true,
"user_course_accessibility": false,
"user_notification_sound": true,
"user_email_course_expires": true,
"user_email_course_releases": true,
"user_email_friendship": true,
"user_email_message": false,
"user_email_suggestion": false,
"user_email_talk": false,
"user_email_news": true,
"user_message_forum_reply": true,
"user_message_reflection_reply": true,
"user_message_course_completed": true,
"user_message_course_expires": true,
"user_message_course_messages": false,
"user_call_course_pending": false,
"user_call_course_releases": false,
"user_whatsapp_course_expires": true,
"user_whatsapp_course_releases": true,
"user_push_talk": true,
"user_push_course_expires": true,
"user_push_course_pending": true,
"user_push_course_releases": true,
"user_push_categories": [
6,
13,
30
]
}
}
|
Atualizar preferências do usuário
Atualiza preferências e opções de privacidade do usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/set-preference |
| Parâmetros: |
token Token de acesso a APIuser_id ID do Usuáriouser_token Token Privado do Usuário (logado)user_language opcional - Idioma de Interface (pt, en, es, fr ou zh)user_course_assistant opcional - Ativar ou Desativar assistente durante o curso (true ou false)user_course_accessibility opcional - Ativar ou Desativar recursos de melhoria de acessibilidade durante o curso (true ou false)user_notification_sound opcional - Ativar ou Desativar sons de notificação (true ou false)user_email_course_expires opcional - Ativar ou Desativar e-mail quando curso vencer (true ou false)user_email_course_releases opcional - Ativar ou Desativar e-mail quando houver lançamentos de curso (true ou false)user_email_friendship opcional - Ativar ou Desativar e-mail quando receber novo pedido de amizade (true ou false)user_email_message opcional - Ativar ou Desativar e-mail quando receber nova mensagem privada (true ou false)user_email_suggestion opcional - Ativar ou Desativar e-mail de sugestões de cursos de amigos (true ou false)user_email_talk opcional - Ativar ou Desativar e-mail quando houver nova transmissão ao vivo (true ou false)user_email_news opcional - Ativar ou Desativar e-mail quando houver novidades (true ou false)user_message_forum_reply opcional - Ativar ou Desativar mensagem quando receber resposta de uma pergunta no Fórum (true ou false)user_message_reflection_reply opcional - Ativar ou Desativar mensagem quando receber resposta de uma Atividade Reflexiva (true ou false)user_message_course_completed opcional - Ativar ou Desativar mensagem quando concluir um curso, para emitir certificado (true ou false)user_message_course_expires opcional - Ativar ou Desativar mensagem quando o curso estiver perto de vencer (true ou false)user_message_course_messages opcional - Ativar ou Desativar mensagem de amigos durante curso (true ou false)user_call_course_pending opcional - Ativar ou Desativar autorização de ligação quando curso estiver pendente de pagamento (true ou false)user_call_course_releases opcional - Ativar ou Desativar autorização de ligação quando houver lançamentos de novos cursos (true ou false)user_whatsapp_course_expires opcional - Ativar ou Desativar autorização de Whatsapp/SMS quando curso estiver próximo de vencer (true ou false)user_whatsapp_course_releases opcional - Ativar ou Desativar autorização de Whatsapp/SMS quando houver lançamentos de novos cursos (true ou false)user_push_talk opcional - Ativar ou Desativar pushs no App quando houver nova transmissão ao vivo (true ou false)user_push_course_expires opcional - Ativar ou Desativar pushs no App quando o curso estiver vencendo (true ou false)user_push_course_pending opcional - Ativar ou Desativar pushs no App quando não acessar o curso há mais de 5 dias (true ou false)user_push_course_releases opcional - Ativar ou Desativar pushs no App quando tiver lançamentos de novos cursos (true ou false)user_push_categories opcional - Ativar ou desativar pushs no App para as categorias de cursos selecionadas (enviar serializado, ex.: 1,2,3,4) |
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Preferências salvas com sucesso!"
}
|
Alterar senha do usuário
Efetua alteração na senha de acesso do usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/set-password |
| Parâmetros: |
token Token de acesso a APIuser_id ID do Usuáriouser_token Token Privado do Usuário (logado)user_password Nova Senha de Acesso para o Usuário
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Senha alterada com sucesso!"
}
|
| Nota importante: | O usuário precisa estar relacionado com a sua empresa, para que tenha permissão de alteração de senha. |
Obter URL de acesso à sala de aula
Ao informar o ID e CPF do usuário, retorna a URL de acesso ao painel principal (AVA).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/get-logged-url |
| Parâmetros: |
token Token de acesso a APIuser_id ID do Usuáriouser_cpf CPF do Usuáriouser_email opcional - utilizado para realizar uma nova busca (no caso de não encontrar por CPF)
expire_url_minutes opcional - use para adicionar validade (em minutos) a URL de login.
|
| Objetos retornados: |
URL URL de acesso à sala de aulaUSER_ID o ID do UsuárioUSER_TOKEN o Token Privado do Usuário
|
| Exemplo de retorno (JSON): |
{
"URL": "https://../url-usuario-logado",
"USER_ID": 2509142,
"USER_TOKEN": "82e47251b78187e0acbacf185ec"
}
|
Obter preferência de tema do usuário
Ao informar o ID e Token do usuário, retorna a preferência do tema escolhido.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/get-theme |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)
|
| Objetos retornados: |
THEME em caso de sucesso, este objeto retornará as propriedades do tema
|
| Exemplo de retorno 1 (JSON): |
{
"THEME": {
"theme": 0,
"interval_hours": "20-05",
"message": "Sua tela vai escurecer automaticamente a partir das 20 horas até as 5 horas da manhã"
}
}
|
| Exemplo de retorno 2 (JSON): |
{
"THEME": {
"theme": 1,
"interval_hours": "00-24",
"message": "Sua tela vai ficar sempre clara"
}
}
|
| Exemplo de retorno 3 (JSON): |
{
"THEME": {
"theme": 2,
"interval_hours": "00-24",
"message": "Sua tela vai ficar sempre escura"
}
}
|
Atualizar preferência de tema do usuário
Efetua alteração no tema do usuário (automático, claro ou escuro).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/set-theme |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)theme Flag para o Tema escolhido (0, 1 ou 2)
|
| Objetos retornados: |
THEME em caso de sucesso, este objeto retornará as propriedades do tema
|
| Exemplo de retorno (JSON): |
{
"THEME": {
"theme": 1,
"interval_hours": "00-24",
"message": "Sua tela vai ficar sempre clara"
}
}
|
Obter painel inicial do AVA
Retorna dados de cursos, professores e próximos cursos.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/get-welcome |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)
|
| Objetos retornados: |
WELCOME em caso de sucesso, use esse objeto para manusear os dados
|
| Exemplo de retorno (JSON): |
{
"WELCOME": {
"title": "Bem-vindo, João!",
"image": "https://..url-to-image",
"description": "Aqui você pode iniciar seus treinamentos...",
"tip_label": "Veja abaixo",
"has_button": true,
"button_label": "Ir para Meus Cursos",
"button_url": "/aulas",
"company_home_banner": "https://..url-to-image", // optional
"company_home_url": "" // optional
},
"SECTIONS": [
{
"title": "Cursos que você deveria fazer",
"headline": "Escolhidos por nossa IA para melhorar sua capacidade de trabalhar em equipe",
"courses": [
{
"course_id": 114420,
"title": "React",
"image": "https://..url-to-image",
"progress": 40,
"progress_label": "Em andamento",
"teacher_photo": "https://..url-to-image"
}
,...
]
}
,...
],
"TEACHERS": {
"title": "Professores em Destaque",
"headline": "Veja os cursos ministrados pelos professores que se destacaram",
"teachers": [
{
"teacher_id": 117,
"teacher_name": "Fabio Bergamo",
"teacher_image": "https://..url-to-image"
}
,...
]
},
"NEXT_COURSES": {
"title": "Próximos Lançamentos",
"headline": "Se prepare para o que vem por aí...",
"courses": [
{
"course_title": "Curso de People Analytics",
"course_image": "https://..url-to-image",
"course_teacher_name": "Mauricio Pereira",
"course_teacher_photo": "https://..url-to-image",
"course_release_date": "2024-04-12",
"course_release_date_left": "2 dias"
}
,...
]
}
}
|
Amigos
Obter lista de amigos de um usuário
Retorna a lista de amigos, com paginação.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/get-friends |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)pending opcional - para retornar somente amigos pendentes de aceitação (true ou false)page opcional - número da página atual (padrão = 1)query opcional - para buscar pelo nome do amigo
|
| Objetos retornados: |
FRIENDS em caso de sucesso, este objeto retornará a lista
|
| Exemplo de retorno (JSON): |
{
"TOTAL_PAGES": 1,
"CURRENT_PAGE": 1,
"FRIENDS": [
{
"user_id": 12345678,
"user_name": "João Nascimento",
"user_first_name": "João",
"user_image_small": "https://...url-to-image"
},
...
]
}
|
Iniciar amizade com outro usuário
Adiciona o usuário como amigo.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/set-friendship |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)profile_id ID do usuário que deseja adicionar como amigo |
| Objetos retornados: |
SUCCESS em caso de sucesso, esta será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Convite de amizade enviado com sucesso!"
}
|
Confirmar amizade com outro usuário
Confirma o pedido de amizade.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/confirm-friendship |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)profile_id ID do amigo
|
| Objetos retornados: |
SUCCESS em caso de sucesso, esta será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Convite aceito com sucesso!"
}
|
Desfazer amizade com outro usuário
Remove o usuário como amigo.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/del-friendship |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)profile_id ID do usuário que deseja remover como amigo |
| Objetos retornados: |
SUCCESS em caso de sucesso, esta será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Perfil removido como amigo!"
}
|
Agenda
Obter agenda do usuário (corporativo)
Retorna a lista com dias do mês e registros definidos para o usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/get-calendar |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)month opcional - padrão é o mês atual - se informado, busca agenda do mês/ano (formato YYYY-MM)
|
| Objetos retornados: |
CALENDAR em caso de sucesso, use para manusear os resultados
|
| Exemplo de retorno (JSON): |
{
"MONTH": "2024-03",
"CALENDAR": [
{
"calendar_day": "2024-03-18",
"calendar_title": "Prazo para conclusão do PDI",
"calendar_description": "Seu gestor definiu o dia 18/03/2024 como data final para conclusão do PDI. Acesse para mais detalhes.",
"calendar_url": "https://..url-to-item"
}
,...
]
}
|
Processo de Compra
Criar um carrinho de compras para pagamento
Efetua criação de um carrinho de compras (do lado do servidor do Sie Edtech) para em seguida redirecionar para seu ambiente próprio de pagamento. Utilizado principalmente na modalidade "site pronto" com API do Sie Edtech.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/buying/set-cart |
| Parâmetros: |
token Token de acesso a APIcourse_id ID do Curso - inteiro ou lista*course_type Tipo do Curso (use "2" para plus; "3" para premium; "4" para ilimitado)course_plan Plano do Curso (números de meses de acesso, use "1", "2", "3", "6" ou "12")user_id ID do Usuário - inteiro* Para enviar uma lista de cursos no campo "course_id" você pode utilizar o modelo convencional de array em POST. Exemplo de query-string: course_id[]=1&course_id[]=2... |
| Objetos retornados: |
PAYMENT em caso de sucesso, utilize este objeto para manusear os dados do carrinho
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Carrinho de cursos criado com sucesso!",
"PAYMENT": {
"user_id": 12345,
"course_id": 12345,
"payment_id": 12345,
"payment_url": "https://...url-para-pagamento-da-empresa..."
}
}
|
| Exemplo de código (PHP): |
<?php
// seu token privado e o endpoint desejado da api
$token = 'seu-token-aqui';
$endpoint = '/api/buying/set-cart';
// monta parametros para requisicao
$url = 'https://www.iped.com.br'.$endpoint;
$data = [
'token' => $token,
'course_id' => [69768, 66741],
'course_type' => 3,
'course_plan' => 1,
'user_id' => 1234
];
// executa requisicao
$curl_handle = curl_init();
curl_setopt($curl_handle, CURLOPT_URL, $url);
curl_setopt($curl_handle, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($curl_handle, CURLOPT_POSTFIELDS, $data);
curl_setopt($curl_handle, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl_handle, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($curl_handle, CURLOPT_SSL_VERIFYPEER, 0);
$response = curl_exec($curl_handle);
curl_close($curl_handle);
// tratamento para caso de erros de comunicacao
if (!$response) {
echo 'Falha ao se comunicar com a API: '.$url;
exit;
}
// converte json em array
$response = json_decode($response, true);
// verifica se a api retornou algum erro
if ($response && $response['STATE'] != 1) {
echo $response['ERROR'];
exit;
}
// redireciona para URL de pagamento
header("Location: ".$response['PAYMENT']['payment_url']);
exit;
|
Corporativo
Obter dados de uma empresa
Obtém dados gerais (Nome, CNPJ, URL, Logotipo, etc.) da empresa principal ou de uma filial. Este método só está disponível para empresas que usam o formato "Cobrança por Curso" para site pronto.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/corporate/get-company |
| Parâmetros: |
token Token de acesso a API (empresa pai)company_id opcional - ID da empresa filial, se não for informado será utilizado o ID da empresa pai (do token)
|
| Objetos retornados: |
COMPANY em caso de sucesso, utilize este objeto para manusear os dados da empresa
|
| Exemplo de retorno (JSON): |
{
"COMPANY": [
{
"company_id": 1,
"company_name": "Razão Social da Empresa",
"company_cnpj": "12345678...",
"company_url": "https://www.sie.com.br/url-da-empresa",
"company_logo": "https://...url-da-imagem",
"company_header_color": "#ffffff",
"company_price_course": 89.90,
"company_price_fast": 49.90,
"company_price_unlimited": 499.90,
"company_gateway_type": 0,
"company_gateway_url": "",
"company_site_type": 1,
"company_categories_id": "",
"company_about": "Texto para seção Sobre a empresa...",
"company_resources": [
"aulas",
"cursos",
"metas",
"biblioteca",
...
],
"company_rules": {
"gamification": 1,
"receive_educational_emails": 1,
"include_behavioral_questions_on_courses": 1,
"include_incentive_messages_on_courses": 0,
"quantity_courses_simultaneous": 2,
"quantity_days_to_finish_course": 5,
"quantity_days_to_cancel_course": 5,
"access": 1,
"access_hour_start": "08:00:00",
"access_hour_finish": "18:00:00",
"chat": 1,
"chat_exhibition": 2
}
}
]
}
|
Criar uma empresa (filial)
Cadastra uma empresa filha (subordinada à empresa principal).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/corporate/set-company |
| Parâmetros: |
token Token de acesso a API (empresa pai)company_name Razão Social da nova empresacompany_cnpj CNPJ da nova empresacompany_slug Sufixo de URL para uso no site, ex.: sie.com.br/slug-da-empresacompany_limit Quantidade limite de colaboradores que a empresa pode cadastrar, ex.: 50admin_name Nome completo do Responsáveladmin_cpf CPF do Responsáveladmin_email E-mail do Responsáveladmin_password Senha para o Responsávelallow_courses Flag para permissão de criar cursos e utilizar a biblioteca virtual (0 para "Não" ou 1 para "Sim"). O espaço do seu plano é compartilhado com as empresas filiais.company_permission Bloqueia a empresa de cadastrar pessoas, excluir pessoas ou liberar cursos (1 para bloquear apenas o cadastro e exclusão de pessoas ou 2 para bloquear o cadastro, exclusão de pessoas e também a liberação de cursos).* Ao bloquear uma empresa de liberar cursos, as opções de Trilha de Conhecimento, IA de Assistente ao Gestor e Liberar cursos por Habilidades e Competências não ficam indisponíveis para ela. Caso não deseje mudar as permissões de uma empresa, basta não enviar o parametro ou enviar zero. |
| Objetos retornados: |
COMPANY em caso de sucesso, utilize este objeto para manusear os dados da empresa recém-criada
|
| Exemplo de retorno (JSON): |
{
"COMPANY": [
{
"company_id": 1,
"company_name": "Razão Social da Empresa",
"company_cnpj": "12345678...",
"company_url": "https://www.sie.com.br/url-da-empresa",
"company_admin": {
"admin_name": "Nome do Responsável",
"admin_cpf": "CPF do Responsável",
"admin_email": "E-mail do Responsável"
}
}
]
}
|
Remover uma empresa (filial)
Exclui uma empresa filha (subordinada à empresa principal).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/corporate/del-company |
| Parâmetros: |
token Token de acesso a API (empresa pai)company_id* ID da empresa filialcompany_cnpj* CNPJ da empresa filialcompany_force_remove Forçar remoção instantânea* Informe apenas 1 dos parâmetros, não necessariamente ambos. A remoção instantânea (company_force_remove) só acontecerá caso a empresa exista a mais de 30 dias na base e estará sujeita a cobrança proporcional de uso. |
| Objetos retornados: |
COMPANY em caso de sucesso, retornará os dados da empresa excluída ou agendada para exclusão
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Empresa excluída com sucesso."
"COMPANY": [
{
"company_id": 1,
"company_name": "Razão Social da Empresa",
"company_cnpj": "12345678...",
}
]
}
|
Alterar limite de colaboradores (filial)
Efetua alteração nas preferências de limites de colaboradores de uma empresa filha (subordinada à empresa principal).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/corporate/set-limit |
| Parâmetros: |
token Token de acesso a API (empresa pai)company_id ID da empresa filiallimit Limite de colaboradores para filial - inteiro, ex.: 50
|
| Objetos retornados: |
SUCCESS em caso de sucesso, retornará mensagem informando que limite foi alterado
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Limite alterado para 50 colaboradores."
"COMPANY": [
{
"company_id": 1,
"company_name": "Razão Social da Empresa",
"company_cnpj": "12345678...",
}
]
}
|
Login de empresa (filial)
Retorna URL de acesso ao ambiente administrador da empresa filha (subordinada à empresa principal).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/corporate/login |
| Parâmetros: |
token Token de acesso a API (empresa pai)company_id ID da empresa filialadmin_id ID do Administradoradmin_email E-mail do Administrador |
| Objetos retornados: |
URL em caso de sucesso, retornará uma URL de acesso ao corporativo
|
| Exemplo de retorno (JSON): |
{
"URL": "https://www.sie.com.br/..url-de-acesso.."
}
|
Lista de Colaboradores
Retorna lista de colaboradores de uma empresa, incluindo data de agendamento para exclusão (se houver).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/corporate/get-users |
| Parâmetros: |
token Token de acesso a APIuser_id opcional - para filtrar/buscar pelo ID do Usuáriouser_name opcional - para filtrar/buscar pelo Nome (ou parte dele) do Usuáriouser_email opcional - para filtrar/buscar pelo E-mail (ou parte dele) do Usuáriouser_cpf opcional - para filtrar/buscar pelo CPF do Usuáriopage opcional - número da página atualresults opcional - quantidade de resultados por página (padrão = 20) |
| Objetos retornados: |
USERS em caso de sucesso, retornará uma lista de colaboradores da empresa (vide exemplo)
|
| Exemplo de retorno (JSON): |
{
"STATE": 1,
"TOTAL_PAGES": 16,
"CURRENT_PAGE": 1,
"USERS_TOTAL": 10,
"USERS": [
{
"user_id": 1,
"user_name": "Nome do Colaborador",
"user_email": "email@dominio...",
"user_token": "XPRO...",
"user_groups": [
{
"group_id": 123,
"group_name": "RH"
},
{
"group_id": 321,
"group_name": "Administrativo"
}
],
"exclusion_schedule": "Data agendada para exclusão (se houver)",
},
...
]
}
|
Gerar Relatórios Pedagógicos
Retorna o relatório solicitado de acordo com o tipo (assíncrono).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/corporate/get-report |
| Parâmetros: |
token Token de acesso a APItype Tipo do relatório que deseja gerar
|
| Observação: |
Este endpoint funciona de forma assíncrona. Enquanto o relatório estiver sendo gerado, retornará o status in_progress (ver exemplo 1 abaixo). O relatório pode demorar alguns minutos, a depender da quantidade de usuários da empresa. Recomendamos que seja feito o consumo a cada 1 minuto, até obter o status de relatório pronto: completed (ver exemplo 2 abaixo).
|
| Objetos retornados: |
REPORT quando o relatório estiver pronto
|
| Exemplo de retorno 1 (JSON): |
{
"REPORT": {
"report_status": "in_progress",
"report_type": "complete",
}
}
|
| Exemplo de retorno 2 (JSON): |
{
"REPORT": {
"report_status": "completed",
"report_expires_at": "2026-10-30 02:28:01",
"report_file": "https://www.sie.com.br/admin/...",
"report_type": "complete",
}
}
|
Histórico de Pagamentos
Retorna a lista de faturas da empresa
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/corporate/get-billing |
| Parâmetros: |
token Token de acesso a APIpage opcional - número da página atual, padrão = 1
|
| Objetos retornados: |
PAYMENTS para a lista de pagamentos
|
| Exemplo de retorno (JSON): |
{
"STATE": 1,
"TOTAL_PAGES": 3,
"CURRENT_PAGE": 1,
"PAYMENTS": [
{
"payment_id": "123...",
"payment_amount": "120.00",
"payment_date": "2025-03-07 12:47:07",
"payment_due_date": "2025-03-12",
"payment_status": "Pendente",
"payment_description": "Treinamento de colaboradores",
"payment_fiscal_document": "https://...url-to-document",
"payment_report": "https://...url-to-report"
},
...
]
}
|
Grupos (Corporativo)
Obter grupos da empresa
Retorna a lista de grupos da empresa.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/corporate/get-groups |
| Parâmetros: |
token Token de acesso a APIgroup_id opcional - ID do grupo, se desejar filtrar
|
| Objetos retornados: |
GROUPS em caso de sucesso, retornará a lista de grupos
|
| Exemplo de retorno (JSON): |
{
"GROUPS": [
{
"group_id": 1,
"group_parent_id": 0,
"group_name": "Finanças",
"group_color": "",
"group_limit": "",
"group_access_role": 1,
"group_access_role_start": "",
"group_access_role_end": "",
"group_subgroups": []
},
{
"group_id": 2,
"group_parent_id": 0,
"group_name": "Industrial",
"group_color": "",
"group_limit": "",
"group_access_role": 1,
"group_access_role_start": "",
"group_access_role_end": "",
"group_subgroups": [
{
"group_id": 3,
"group_parent_id": 2,
"group_name": "Demandas",
"group_color": "",
"group_limit": "",
"group_access_role": 1,
"group_access_role_start": "",
"group_access_role_end": "",
"group_subgroups": []
}
]
},
...
]
}
|
Criar um grupo
Adiciona um novo grupo para a empresa.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/corporate/set-group |
| Parâmetros: |
token Token de acesso a APIgroup_name Nome do grupogroup_parent_id opcional - ID do grupo paigroup_color opcional - cor de fundo para o grupo, formato HEX (ex.: #333333) - usado no organograma e trilhasgroup_limit opcional - limite de colaboradoresgroup_access_role opcional - regras de acesso, padrão é sempre permitir qualquer dia e horário (veja as opções)
group_access_role_start opcional - horário de início das atividades (formato: 08:00)group_access_role_end opcional - horário de fim das atividades (formato: 18:00)
|
| Objetos retornados: |
SUCCESS em caso de sucesso, retornará o ID do grupo criado
|
| Exemplo de retorno (JSON): |
{
"GROUP_ID": 1,
"SUCCESS": "Grupo criado com sucesso"
}
|
Editar um grupo
Edita um grupo da empresa.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/corporate/edit-group |
| Parâmetros: |
token Token de acesso a APIgroup_id ID do grupo que será alteradogroup_name opcional - Nome do grupogroup_parent_id opcional - ID do grupo paigroup_color opcional - cor de fundo para o grupo, formato HEX (ex.: #333333) - usado no organograma e trilhasgroup_limit opcional - limite de colaboradoresgroup_access_role opcional - regras de acesso (veja as opções)
group_access_role_start opcional - horário de início das atividades (formato: 08:00)group_access_role_end opcional - horário de fim das atividades (formato: 18:00)
|
| Objetos retornados: |
SUCCESS em caso de sucesso, retornará o ID do grupo alterado
|
| Exemplo de retorno (JSON): |
{
"GROUP_ID": 1,
"SUCCESS": "Grupo alterado com sucesso"
}
|
Excluir um grupo
Remove um grupo da empresa.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/corporate/del-group |
| Parâmetros: |
token Token de acesso a APIgroup_id ID do grupo que será excluído |
| Objetos retornados: |
SUCCESS em caso de sucesso, retornará o ID do grupo excluído
|
| Aviso importante: | Ao excluir um grupo, todos os subgrupos que existirem abaixo dele também serão removidos |
| Exemplo de retorno (JSON): |
{
"GROUP_ID": 1,
"SUCCESS": "Grupo excluído com sucesso"
}
|
Reagrupar colaboradores
Reagrupa os colaboradores da empresa em grupos.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/corporate/set-regroup |
| Parâmetros: |
token Token de acesso a APIusers_id ID do Colaborador (ou uma lista)groups_id ID do novo Grupo (ou uma lista)action opcional - Ação de reagrupamento:overwrite (padrão) sobrescreve os grupos que o colaborador tiver atualmente, pelos novos informadosadd insere o colaborador nos novos grupos informados (se ela tiver em outros grupos, mantém)delete remove o colaborador dos grupos informados
|
| Objetos retornados: |
SUCCESS em caso de sucesso.
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Reagrupamento realizado com sucesso."
}
|
| Exemplo de retorno 2 (JSON): |
{
"ERROR": "O máximo de registros aceito é de 200.",
"STATE": 0
}
|
Matrícula
Criar matrícula
Efetua matrícula de um novo aluno e associa um curso (ou plano de cursos) na mesma chamada.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/set-registration |
| Parâmetros: |
token Token de acesso a APIcourse_id ID do Curso - inteiro ou lista*course_type Tipo do Curso (use "2" para plus; "3" para premium; "4" para ilimitado)course_plan Plano do Curso (números de meses de acesso, use "1", "2", "3", "6" ou "12")user_id ID do Usuário - inteiro ou lista* (em caso de um novo usuário, mantenha em branco ou use "0")user_name Nome do Usuário (obrigatório para um novo usuário)user_cpf CPF do Usuário (obrigatório para um novo usuário, informe um CPF válido - para brasileiros - ou Documento de Identificação - para estrangeiros)user_email E-mail do Usuário (obrigatório para um novo usuário)user_password Senha do Usuário (obrigatório para um novo usuário)force_new_password opcional - Flag para alterar a senha do usuário mesmo em caso de já existir um cadastro prévio (informar valor "1")user_country País do Usuário - valor inteiro (veja a lista) - o padrão é "34" (Brasil)user_genre Sexo do Usuário (obrigatório para um novo usuário, use "1" para masculino, "0" para feminino e "2" para outros)user_cellphone opcional - Celular (informar no formato (99)99999-9999)user_info opcional - Informação Extra do Usuário (um campo extra para informar qualquer informação extra sobre o usuário, como um número de registro interno, será exibido nos relatórios do 'Sie Edtech')user_occupation opcional - Área de Atuação do Usuário (veja a lista)user_professional_position opcional - Cargo do usuário
group_id opcional - ID do Grupo (se quiser gerenciar este usuário no 'Sie Edtech' - obtenha o ID do Grupo no 'Sie Edtech')only_fast opcional - Informe = "1" para ativar acesso somente a cursos rápidostutor_ia opcional - Informe = "1" para ativar Tutoria com Inteligência Artificial* Para enviar uma lista de cursos no campo "course_id", ou lista de usuários no campo "user_id", você pode utilizar o modelo convencional de array em POST. Exemplo de query-string: course_id[]=1&course_id[]=2... |
| Objetos retornados: |
REGISTRATION em caso de sucesso, isto retornará os ID's registrados (veja exemplos 1 e 2)
|
| Observações Importantes: |
|
| Exemplo de retorno 1 (JSON): |
{
"SUCCESS": "Novo aluno cadastrado e habilitado com sucesso.",
"REGISTRATION": {
"course_id": 208,
"user_id": 509341,
"user_data": [
{
"user_id": 509341,
"user_token": "82e47251b78187e0acbacf185ec"
}
]
},
"STATE": 1
}
PS.: Os objetos |
| Exemplo de retorno 2 (JSON): |
{
"SUCCESS": "Aluno já cadastrado foi habilitado com sucesso.",
"REGISTRATION": {
"course_id": [7531, 69724],
"user_id": [208551, 509341],
"user_data": [
{
"user_id": 208551,
"user_token": "91f102k92e872uytq02ec#mb160"
},
{
"user_id": 509341,
"user_token": "82e47251b78187e0acbacf185ec"
}
]
},
"STATE": 2
}
PS.: Os objetos |
| Exemplo de retorno 3 (JSON): |
{
"ERROR": "Empresa não possui licenças suficientes para habilitar este curso.",
"STATE": 0
}
|
Cancelar matrícula (sem excluir dados de certificado, etc.)
Efetua a exclusão (ou agendamento) da relação de "Colaborador x Empresa" e a empresa deixa de pagar por esse colaborador. Não apaga certificados e dados de estudo desse aluno.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/del-registration |
| Parâmetros: |
token Token de acesso a APIuser_id ID do Usuáriouser_email opcional - E-mail do Usuário (campo adicional, caso não informe o user_id)
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Aluno excluído com sucesso!",
"USER_ID": 2172,
"PROTOCOL": "Número do protocolo da exclusão"
}
|
Cancelar matrícula (com exclusão de dados)
Efetua a exclusão (ou agendamento de exclusão) de um colaborador da empresa. Também envia um e-mail ao colaborador para decidir sobre a exclusão total dos dados.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/user/del-registration-data |
| Parâmetros: |
token Token de acesso a APIuser_id ID do Usuário (associado à empresa)
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Aluno excluído com sucesso!",
"USER_ID": 2172,
"PROTOCOL": "Número do protocolo da exclusão"
}
|
| Exemplo do e-mail recebido pelo colaborador: |
...recebemos uma solicitação da empresa para excluir todos os seus dados, inclusive certificados. O que você deseja fazer? • Opção 1: Desejo manter minhas certificações, porém essa empresa não pode ter acesso a meus dados • Opção 2: Desejo excluir todos os meus dados, inclusive todas as certificações e atividades que existam |
| Nota importante: | O e-mail será enviado ao colaborador somente se a sua empresa for a responsável pelo cadastro dele. Ou seja, foi a primeira empresa a cadastrar ele na base de dados de milhões de alunos do Sie Edtech. Caso sua empresa apenas liberou cursos, sem ter efetivamente cadastrado os dados desse colaborador, a relação com sua empresa será excluída, mas os dados do aluno, certificações e tudo mais permanecem. |
Categorias
Obter categorias de cursos
Retorna a lista de categorias de cursos, podendo ser informados filtros de busca.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/category/get-categories |
| Parâmetros: |
token Token de acesso a APIquery opcional - para filtrar/buscar pelo Título da Categoriaslug opcional - para filtrar/buscar pela URL amigável da categoria (slug)
all_formats opcional - Informe true se desejar retorna todos os formatos de cursos (não somente vídeo por padrão)
|
| Objetos retornados: |
CATEGORIES em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"CATEGORIES": [
{
"category_id": 2,
"category_title": "Administração",
"category_description": "Descrição aqui...",
"category_slug": "administracao",
"category_courses_total": 120,
"category_image": "https://url-to-big-image",
"category_icon": "https://url-to-icon"
}
,...
]
}
|
| Exemplo de código (PHP): |
Veja este exemplo em execução<?php
// seu token privado e o endpoint desejado da api
$token = 'seu-token-aqui';
$endpoint = '/api/category/get-categories';
// monta url e parametros para requisicao
$url = 'https://www.iped.com.br'.$endpoint;
$data = [
'token' => $token
];
// executa requisicao
$curl_handle = curl_init();
curl_setopt($curl_handle, CURLOPT_URL, $url);
curl_setopt($curl_handle, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($curl_handle, CURLOPT_POSTFIELDS, $data);
curl_setopt($curl_handle, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl_handle, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($curl_handle, CURLOPT_SSL_VERIFYPEER, 0);
$response = curl_exec($curl_handle);
curl_close($curl_handle);
// tratamento para caso de erros de comunicacao
if (!$response) {
echo 'Falha ao se comunicar com a API: '.$url;
exit;
}
// converte json em array
$response = json_decode($response, true);
// verifica se a api retornou algum erro
if ($response && $response['STATE'] != 1) {
echo $response['ERROR'];
exit;
}
// tratamento para o caso de retornar uma lista vazia
if (!$response['CATEGORIES']) {
echo 'Nenhuma categoria encontrada';
exit;
}
// inicia html de exemplo
echo '<html>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Categorias</title>
</head>';
// css de exemplo
echo '<style>
body{font-family:arial;margin:20px}
h1{font-weight:normal;margin:30px 10px}
#categories{font-size:85%}
#categories,#categories li{margin:0;padding:0;list-style:none}
#categories li a{display:block;box-sizing:border-box;text-decoration:none;border:solid #e8e8e8 1px;border-radius:5px;float:left;margin:10px;width:30%;color:#333;min-height:25px;padding:15px}
#categories li a:hover{background:#e8e8e8}
#categories li a span{color:#999}
@media(max-width:900px) {#categories li a{width:40%}}
@media(max-width:600px) {#categories li a{width:100%;margin:0;margin-bottom:15px;}}
</style>';
// html de exemplo
echo '<body>
<h1>Lista de Categorias</h1>';
// exibe categorias (lista)
echo '<ul id="categories">';
foreach($response['CATEGORIES'] AS $category) {
echo '<li>
<a href="cursos.php?cat='.$category["category_id"].'">
'.$category['category_title'].'
<span> ('.$category['category_courses_total'].' cursos)</span>
</a>
</li>';
}
echo '</ul>';
// finaliza html de exemplo
echo '</body>
</html>';
|
Obter categorias e cursos agrupados
Retorna a lista de categorias e seus cursos, podendo ser informados filtros de busca.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/get-categories-courses |
| Parâmetros: |
token Token de acesso a APIuser_id opcional - para filtrar/buscar por ID do Usuáriocategory_id opcional - para filtrar/buscar por ID de Categoriacategory_slug opcional - para filtrar/buscar por Slug de Categoriacourse_id opcional - para filtrar/buscar por ID do Cursocourse_slug opcional - para filtrar/buscar por Slug do Cursoquery opcional - para filtrar/buscar por Títulotype opcional - use "1" para "cursos premium", "2" para "cursos rápidos" ou "3" para "cursos sob medida"always_show opcional - use "1" para exibir "cursos rápidos" quando o usuário não tiver nenhum liberadoexternal_lms opcional - use "1" para retornar a URL de acesso à sala de aula. Neste caso, é obrigatório enviar junto também o parâmetro user_tokenexpire_url_minutes opcional - use para adicionar validade (em minutos) a URL de acesso à sala de aula. Neste caso, é obrigatório enviar junto também o parâmetro external_lmsinprogress opcional - use true para retornar somente cursos em andamento do usuárioinclude_topics opcional - use "1" para incluir os tópicos do cursoinclude_skills opcional - use "1" para incluir as habilidades do cursoinclude_all opcional - use "1" para incluir os cursos secundários da áreaiped_only opcional - use "1" para buscar somente por cursos do Sie Edtech
all_formats opcional - Informe true se desejar retorna todos os formatos de cursos (não somente vídeo por padrão)
|
| Objetos retornados: |
CATEGORIES em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"CATEGORIES": [
{
"category_id": 1,
"category_title": "3D e Games",
"category_description": "Descrição aqui...",
"category_slug": "3d-e-games",
"category_courses": [
{
"course_id": 54828,
"course_company_id": 1,
"course_title": "Curso de 3D Game Studio na Prática",
"course_description": "Descrição aqui...",
"course_slug": "3d-game-studio-na-pratica",
"course_free": 0,
"course_format": 1,
"course_category_id": 1,
"course_rating": 4,
"course_students": 1964,
"course_captions": [
"pt",
"en"
],
"course_hours": 80,
"course_minutes": 0,
"course_video": "https://../url-do-video-apresentacao",
"course_image": "https://../url-da-imagem",
"course_slideshow": [
"https://../url-da-imagem-1",
"https://../url-da-imagem-2",
"https://../url-da-imagem-3"
],
"course_teacher": {
"teacher_name": "Nome do professor...",
"teacher_description": "Descrição do professor...",
"teacher_image": "https://../url-da-imagem"
},
"course_price": 89,
"course_user": {
"user_id": 1,
"user_course_completed": 55,
"user_course_grade": 70, // aproveitamento em %
"user_course_format": 2
}
}
]
,...
}
,...
]
}
Nota: |
Obter cursos de uma categoria
Retorna a lista de cursos de uma categoria, podendo ser informados filtros de busca.
Nota: Utilize o método Obter lista de cursos, informando o parâmetro category_id ou category_slug.
Cursos
Obter lista de cursos
Retorna a lista de cursos, podendo ser informados filtros de busca.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/get-courses |
| Parâmetros: |
token Token de acesso a APIuser_id opcional - para filtrar/buscar por ID do Usuáriocategory_id opcional - para filtrar/buscar por ID de Categoriacategory_slug opcional - para filtrar/buscar por Slug de Categoriaprofession_id opcional - para filtrar/buscar por Profissãocourse_id opcional - para filtrar/buscar por ID do Curso (podendo ser um inteiro ou uma lista)teacher_id opcional - para filtrar/buscar por ID do Professor (inteiro)query opcional - para filtrar/buscar pelo Título do Cursoslug opcional - para filtrar/buscar pela URL amigável do curso (slug)type opcional - use "1" para "cursos premium", "2" para "cursos rápidos" ou "3" para "cursos sob medida"always_show opcional - use "1" para exibir "cursos rápidos" quando o usuário não tiver nenhum liberadoorder opcional - ordenação do resultado: use "title" (padrão) para ordenar pelo título do curso; "relevance" para ordenar por relevância (votação e alunos em curso); "date" para ordenar por data de lançamento (mais novos primeiro)page opcional - número da página atual, padrão = 1results opcional - quantidade de resultados por página (padrão = 20; máximo = 100)external_lms opcional - use "1" para retornar a URL de acesso à sala de aula. Neste caso, é obrigatório também enviar junto o parâmetro user_tokenexpire_url_minutes opcional - use para adicionar validade (em minutos) a URL de acesso à sala de aula. Neste caso, é obrigatório enviar junto também o parâmetro external_lmsinclude_topics opcional - use "1" para incluir os tópicos do cursoinclude_skills opcional - use "1" para incluir as habilidades do cursoinclude_unlimited opcional - use "1" para incluir o "Plano Ilimitado" na lista de cursosiped_only opcional - use "1" para buscar somente por cursos do Sie Edtech
all_formats opcional - Informe true se desejar retorna todos os formatos de cursos (não somente vídeo por padrão)
|
| Objetos retornados: |
COURSES em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"TOTAL_PAGES": 6,
"CURRENT_PAGE": 1,
"COURSES": [
{
"course_id": 54828,
"course_company_id": 1,
"course_title": "Curso de 3D Game Studio na Prática",
"course_description": "Descrição aqui...",
"course_slug": "3d-game-studio-na-pratica",
"course_free": 0,
"course_format": 1,
"course_category_id": 1,
"course_category_slug": "slug-categoria",
"course_category_title": "Título da Categoria",
"course_rating": 4,
"course_students": 1964,
"course_captions": [
"pt",
"en"
],
// Caso envie o parametro user_id a api irá chegar se o usuário tem IA implementada.
"course_ia_enable": false,
// Caso o usuário não tenha ia implementada, a api irá retornar opção para comprar a IA
"course_ia_payment": {
"name": "Lina",
"image": "https://www.iped.com.br/_img/ia/1/imagem.jpg",
"link": "https://www.iped.com.br/comprar/0?tipo=3&comprar_ia=1&mensal=1&user_id=396946&user_token=07f97e68e9bfa9d4a2b3333c745a0bc09573f5f6",
"link_app": "https://www.iped.com.br/api/form/submit?user_id=396946",
"text": "Adquirir por R$ 29,90",
"value": 29.9,
"description": "Sistema de inteligência Artificial treinado para orientá-lo nos estudos"
},
"course_hours": 80,
"course_minutes": 0,
"course_video": "https://../url-do-video-apresentacao",
"course_image": "https://../url-da-imagem",
"course_slideshow": [
"https://../url-da-imagem-1",
"https://../url-da-imagem-2",
"https://../url-da-imagem-3"
],
"course_teacher": {
"teacher_name": "Nome do professor...",
"teacher_description": "Descrição do professor...",
"teacher_image": "https://../url-da-imagem"
},
"course_price": 89,
"course_user": {
"user_id": 1,
"user_course_completed": 55, // etapa do curso em %
"user_course_grade": 70, // aproveitamento em %
"user_course_format": 2,
"user_course_start_date": "2025-01-01",
"user_course_conclusion_date": "2025-01-25",
"user_course_last_access": "2025-01-25",
"user_course_rating": 5, // nota de 1 a 5 estrelas
"user_course_testimonial": "Gostei do curso"
}
}
,...
]
}
Nota: |
| Exemplo de código (PHP): |
Veja este exemplo em execução<?php
// seu token privado e o endpoint desejado da api
$token = 'seu-token-aqui';
$endpoint = '/api/course/get-courses';
// valores padrao para busca
$category_id = 1; // busca padrao pela categoria id 1
$page = 1; // busca padrao pela pagina 1
// verifica se possui paginacao na URL
if (isset($_GET['page']) && $_GET['page'] > 1) {
$page = (int)$_GET['page'];
}
// verifica se possui categoria na URL
if (isset($_GET['cat']) && $_GET['cat'] > 1) {
$category_id = (int)$_GET['cat'];
}
// monta url e parametros para requisicao
$url = 'https://www.iped.com.br'.$endpoint;
$data = [
'token' => $token,
'category_id' => $category_id,
'page' => $page
];
// executa requisicao
$curl_handle = curl_init();
curl_setopt($curl_handle, CURLOPT_URL, $url);
curl_setopt($curl_handle, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($curl_handle, CURLOPT_POSTFIELDS, $data);
curl_setopt($curl_handle, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl_handle, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($curl_handle, CURLOPT_SSL_VERIFYPEER, 0);
$response = curl_exec($curl_handle);
curl_close($curl_handle);
// tratamento para caso de erros de comunicacao
if (!$response) {
echo 'Falha ao se comunicar com a API: '.$url;
exit;
}
// converte json em array
$response = json_decode($response, true);
// verifica se a api retornou algum erro
if ($response && $response['STATE'] != 1) {
echo $response['ERROR'];
exit;
}
// tratamento para o caso de retornar uma lista vazia
if (!$response['COURSES']) {
echo 'Nenhum curso localizado';
exit;
}
// inicia html de exemplo
echo '<html>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Cursos de '.$response['COURSES'][0]['course_category_title'].'</title>
</head>';
// css de exemplo
echo '<style>
body{font-family:arial;margin:20px}
h1{font-weight:normal;margin:30px 10px}
#courses{clear:both}
#courses,#courses li{margin:0;padding:0;list-style:none}
#courses li a,#courses li a img,#courses li a span{display:block}
#courses li a{box-sizing:border-box;text-decoration:none;background:#f0f0f0;float:left;margin:10px;width:290px;color:#333;min-height:350px;overflow:hidden;border-radius:5px}
#courses li a img{width:100%;opacity:0.8}
#courses li a:hover{background:#e8e8e8}
#courses li a:hover img{opacity:1}
#courses li a span{padding:15px 20px}
#courses li a span.title{font-weight:bold}
#courses li a span.description{font-size:80%}
@media(max-width:600px) {#courses li a{width:100%;float:none;margin:0;margin-bottom:25px;}}
</style>';
// html de exemplo
echo '<body>
<h1>Cursos de '.$response['COURSES'][0]['course_category_title'].'</h1>';
// funcao auxiliar para resumo da descricao
function truncate($text, $chars = 100) {
if (strlen($text) <= $chars) {
return $text;
}
$text = $text.' ';
$text = substr($text,0,$chars);
$text = substr($text,0,strrpos($text,' '));
$text = $text.'...';
return $text;
}
// exibe cursos (lista)
echo '<ul id="courses">';
foreach($response['COURSES'] AS $course) {
echo '<li>
<a href="curso.php?id='.$course["course_id"].'">
<img src="'.$course['course_image'].'" />
<span class="title">'.$course['course_title'].'</span>
<span class="description">'.truncate($course['course_description']).'</span>
</a>
</li>';
}
echo '</ul>';
// finaliza html de exemplo
echo '</body>
</html>';
|
Obter detalhes de um curso
Retorna detalhes de um curso, podendo ser retornado também os tópicos.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/get-courses |
| Parâmetros: |
token Token de acesso a APIcourse_id - para filtrar/buscar por ID do Cursoinclude_topics - use "1" para incluir os tópicos do curso
all_formats opcional - Informe true se desejar retorna todos os formatos de cursos (não somente vídeo por padrão)
|
| Objetos retornados: |
COURSES em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"TOTAL_PAGES": 1,
"CURRENT_PAGE": 1,
"COURSES": [
{
"course_id": 54828,
"course_company_id": 1,
"course_title": "Curso de 3D Game Studio na Prática",
"course_description": "Descrição aqui...",
"course_slug": "3d-game-studio-na-pratica",
"course_free": 0,
"course_format": 1,
"course_category_id": 1,
"course_category_slug": "slug-categoria",
"course_category_title": "Título da Categoria",
"course_rating": 4,
"course_students": 1964,
"course_captions": [
"pt",
"en"
],
"course_hours": 80,
"course_video": "https://../url-do-video-apresentacao",
"course_image": "https://../url-da-imagem",
"course_slideshow": [
"https://../url-da-imagem-1",
"https://../url-da-imagem-2",
"https://../url-da-imagem-3"
],
"course_teacher": {
"teacher_name": "Nome do professor...",
"teacher_description": "Descrição do professor...",
"teacher_image": "https://../url-da-imagem"
},
"course_price": 89,
"course_user": {
"user_id": 1,
"user_course_completed": 55,
"user_course_grade": 70, // aproveitamento em %
"user_course_format": 2
}
}
]
}
|
| Exemplo de código (PHP): |
Veja este exemplo em execução<?php
// seu token privado e o endpoint desejado da api
$token = 'seu-token-aqui';
$endpoint = '/api/course/get-courses';
// verifica se informou o id do curso na URL
if (!isset($_GET['id']) || (int)$_GET['id'] == 0) {
echo 'Informe o ID do curso';
exit;
}
// reserva id do curso para os parametros da requisicao
$course_id = (int)$_GET['id'];
// monta url e parametros para requisicao
$url = 'https://www.iped.com.br'.$endpoint;
$data = [
'token' => $token,
'course_id' => $course_id,
'include_topics' => 1
];
// executa requisicao
$curl_handle = curl_init();
curl_setopt($curl_handle, CURLOPT_URL, $url);
curl_setopt($curl_handle, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($curl_handle, CURLOPT_POSTFIELDS, $data);
curl_setopt($curl_handle, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl_handle, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($curl_handle, CURLOPT_SSL_VERIFYPEER, 0);
$response = curl_exec($curl_handle);
curl_close($curl_handle);
// tratamento para caso de erros de comunicacao
if (!$response) {
echo 'Falha ao se comunicar com a API: '.$url;
exit;
}
// converte json em array
$response = json_decode($response, true);
// verifica se a api retornou algum erro
if ($response && $response['STATE'] != 1) {
echo $response['ERROR'];
exit;
}
// tratamento para o caso de retornar uma lista vazia
if (!$response['COURSES']) {
echo 'Nenhum curso encontrado';
exit;
}
// retorna unico resultado para uma variavel
$course = current($response['COURSES']);
// inicia html de exemplo
echo '<html>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>'.$course['course_title'].'</title>
</head>';
// css de exemplo
echo '<style>
body{font-family:arial;margin:20px}
h1,h2,p{font-weight:normal;margin:30px 10px;clear:both}
h2{margin-top:40px}
p,li{line-height:1.5}
p.course-teacher img{float:left;border-radius:100px;width:100px;height:100px;margin-right:25px}
#slides{text-align:center}
.slide-controller:nth-child(1):checked ~ .slide-show .slides-list{--selected-item: 0}
.slide-controller:nth-child(2):checked ~ .slide-show .slides-list{--selected-item: 1}
.slide-controller:nth-child(3):checked ~ .slide-show .slides-list{--selected-item: 2}
.slide-show{overflow:hidden}
.slides-list{--selected-item:0;--total-items:3;list-style-type:none;margin:10px 0;padding:0;position:relative;left:calc(var(--selected-item) * -100%);width:calc(var(--total-items) * 100%);transition:left 0.4s cubic-bezier(0.680, -0.550, 0.265, 1.550);display:grid;grid-auto-flow:column;grid-auto-columns:1fr}
.slide{width:100%}
.slide img{border-radius:5px}
</style>';
// funcao auxiliar para exibir player de video
function video_player($url) {
preg_match('#(\.be/|/embed/|/v/|/watch\?v=)([A-Za-z0-9_-]{5,11})#', $url, $match);
return '<iframe width="100%" height="450" src="//www.youtube.com/embed/'.$match[2].'?wmode=transparent&autohide=1&rel=0&showinfo=0&showsearch=0&iv_load_policy=3&modestbranding=1" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>';
}
// html de exemplo
echo '<body>
<h1>'.$course['course_title'].'</h1>
<h2>Vídeo de Apresentação</h2>
<p>'.video_player($course['course_video']).'</p>
<h2>Imagens do curso</h2>
<div id="slides">
<input type="radio" class="slide-controller" name="slide" checked />
<input type="radio" class="slide-controller" name="slide" />
<input type="radio" class="slide-controller" name="slide" />
<div class="slide-show">
<ul class="slides-list">';
foreach($course['course_slideshow'] AS $image) {
echo '<li class="slide"><img src="'.$image.'" /></li>';
}
echo '</ul>
</div>
</div>
<h2>Descrição</h2>
<p>'.$course['course_description'].'</p>
<h2>Tópicos</h2>
<ul>';
foreach($course['course_topics'] AS $topic) {
echo '<li>'.$topic.'</li>';
}
echo '</ul>
<h2>Professor</h2>
<p class="course-teacher"><img src="'.$course['course_teacher']['teacher_image'].'" />
<strong>'.$course['course_teacher']['teacher_name'].'</strong>
'.$course['course_teacher']['teacher_description'].'</p>';
// finaliza html de exemplo
echo '</body>
</html>';
|
Obter cursos em destaque do usuário
Retorna cursos indicados para o usuário, de acordo o plano dele.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/get-featured |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuário (utilizado para verificar os tipos do curso)
all_formats opcional - Informe true se desejar retorna todos os formatos de cursos (não somente vídeo por padrão)
|
| Objetos retornados: |
COURSES em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"COURSES": [
{
"course_id": 54828,
"course_company_id": 1,
"course_title": "Curso de 3D Game Studio na Prática",
"course_description": "Descrição aqui...",
"course_slug": "3d-game-studio-na-pratica",
"course_free": 0,
"course_format": 1,
"course_category_id": 1,
"course_category_slug": "slug-categoria",
"course_rating": 4,
"course_students": 1964,
"course_captions": [
"pt",
"en"
],
"course_hours": 80,
"course_minutes": 0,
"course_video": "https://../url-do-video-apresentacao",
"course_image": "https://../url-da-imagem",
"course_slideshow": [
"https://../url-da-imagem-1",
"https://../url-da-imagem-2",
"https://../url-da-imagem-3"
],
"course_teacher": {
"teacher_name": "Nome do professor...",
"teacher_description": "Descrição do professor...",
"teacher_image": "https://../url-da-imagem"
}
}
,...
]
}
|
Obter cursos relacionados
Retorna a lista de cursos relacionado com outro curso.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/get-related |
| Parâmetros: |
token Token de acesso a APIcategory_id ID da Categoriacourse_id ID do Curso atual; ele não será exibido nos resultadosiped_only opcional - use "1" para buscar somente por cursos do Sie Edtech
|
| Objetos retornados: |
COURSES em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"COURSES": [
{
"course_id": 54828,
"course_company_id": 1,
"course_title": "Curso de 3D Game Studio na Prática",
"course_description": "Descrição aqui...",
"course_slug": "3d-game-studio-na-pratica",
"course_free": 0,
"course_format": 1,
"course_category_id": 1,
"course_category_slug": "slug-categoria",
"course_rating": 4,
"course_students": 1964,
"course_captions": [
"pt",
"en"
],
"course_hours": 80,
"course_minutes": 0,
"course_video": "https://../url-do-video-apresentacao",
"course_image": "https://../url-da-imagem",
"course_slideshow": [
"https://../url-da-imagem-1",
"https://../url-da-imagem-2",
"https://../url-da-imagem-3"
],
"course_teacher": {
"teacher_name": "Nome do professor...",
"teacher_description": "Descrição do professor...",
"teacher_image": "https://../url-da-imagem"
}
}
,...
]
}
|
Obter cursos concluídos
Retorna a lista de cursos finalizados de um usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/get-completed |
| Parâmetros: |
token Token de acesso a APIuser_id ID do Usuário
|
| Objetos retornados: |
COURSES em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"COURSES": [
{
"course_id": 54828,
"course_title": "Curso de 3D Game Studio na Prática",
"course_description": "Descrição aqui...",
"course_image": "https://../url-da-imagem",
"course_percentage": 100
}
,...
]
}
|
Obter cursos em progresso (em andamento)
Retorna a lista de cursos em andamento de um usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/get-inprogress |
| Parâmetros: |
token Token de acesso a APIuser_id ID do Usuáriocategory_id opcional - para filtrar/buscar por Categoriacourse_id opcional - para filtrar/buscar por ID do Cursoquery opcional - para filtrar/buscar por Títulotype opcional - use "1" para "cursos premium" ou "2" para "cursos rápidos"external_lms opcional - use "1" para retornar a URL de acesso à sala de aula. Neste caso, é obrigatório também enviar junto o parâmetro user_token
expire_url_minutes opcional - use para adicionar validade (em minutos) a URL de acesso à sala de aula. Neste caso, é obrigatório enviar junto também o parâmetro external_lmsall_formats opcional - Informe true se desejar retorna todos os formatos de cursos (não somente vídeo por padrão)
|
| Objetos retornados: |
COURSES em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"COURSES": [
{
"course_id": 54828,
"course_company_id": 1,
"course_title": "Curso de 3D Game Studio na Prática",
"course_description": "Descrição aqui...",
"course_slug": "3d-game-studio-na-pratica",
"course_free": 0,
"course_format": 1,
"course_category_id": 1,
"course_category_slug": "slug-categoria",
"course_rating": 4,
"course_students": 1964,
"course_captions": [
"pt",
"en"
],
"course_hours": 80,
"course_minutes": 0,
"course_video": "https://../url-do-video-apresentacao",
"course_image": "https://../url-da-imagem",
"course_slideshow": [
"https://../url-da-imagem-1",
"https://../url-da-imagem-2",
"https://../url-da-imagem-3"
],
"course_teacher": {
"teacher_name": "Nome do professor...",
"teacher_description": "Descrição do professor...",
"teacher_image": "https://../url-da-imagem"
},
"course_user": {
"user_id": 1,
"user_course_completed": 55,
"user_course_grade": 70, // aproveitamento em %
"user_course_format": 2
}
}
,...
]
}
|
Requisitar curso (corporativo)
Envia requisição ao gestor (empresa precisa ativar isso).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/set-request |
| Parâmetros: |
token Token de acesso a APIuser_id ID do Usuáriouser_token Token do Usuário logadocourse_id ID do Curso para requisitarmessage Mensagem enviada ao gestor
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isso será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Solicitação enviada com sucesso!"
}
|
Obter lista de professores
Retorna lista de alguns professores dos cursos.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/get-teachers |
| Parâmetros: |
token Token de acesso a API
|
| Objetos retornados: |
TEACHERS em caso de sucesso, use esse objeto para manusear os dados
|
| Exemplo de retorno (JSON): |
{
"TEACHERS": [
{
"teacher_id": 1,
"teacher_name": "João dos Santos",
"teacher_first_name": "João"
}
,...
]
}
|
Enviar sugestão
Envia sugestão aos gestores.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/set-suggest |
| Parâmetros: |
token Token de acesso a APIuser_id ID do Usuáriouser_token Token do Usuário logadosuggestion Sugestão para enviar
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isso será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Sugestão enviada com sucesso!"
}
|
ENEM
Obter lista de cursos (universidade)
Retorna lista de cursos com notas de corte (min e max).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/enem/get-university-courses |
| Parâmetros: |
token Token de acesso a API
|
| Objetos retornados: |
COURSES em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"COURSES": [
{
"course_id": 1,
"course_title": "Administração",
"course_score_min": 100,
"course_score_max": 200
},
{
"course_id": 2,
"course_title": "Comunicação"
"course_score_min": 120,
"course_score_max": 250
}
,...
]
}
|
Obter visão geral do usuário
Retorna dados consolidados para relatório do ENEM do usuário (precisa estar habilitado).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/enem/get-summary |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)
|
| Objetos retornados: |
ENEM em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"ENEM": {
"enem_user": {
"user_id": 1,
"user_name": "João dos Santos",
"user_first_name": "João",
"user_image": "https://..url-to-image",
},
"enem_quiz": {
"quiz_url": "https://..url-to-quiz",
"quiz_score": 120,
"quiz_completed": 30, // percentage %
"quiz_total_correct": 27,
"quiz_total_wrong": 27,
"quiz_areas": [
{
"area_name": "Ciências Naturais",
"area_quiz_correct": 2
"area_quiz_total": 13,
},
{
"area_name": "Ciências Humanas",
"area_quiz_correct": 32
"area_quiz_total": 7,
}
,...
]
}
"enem_ranking": {
"ranking_position": 4462,
"ranking_near": [
{
"user_position": 4459,
"user_name": "Irlanda Conceição",
"user_image": "https://...url-to-image",
"user_score": 100
}
,...
]
}
}
}
|
Obter relatório por matéria do usuário
Retorna notas de cada matéria para relatório do ENEM do usuário (precisa estar habilitado).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/enem/get-report |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)
|
| Objetos retornados: |
ENEM em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"ENEM": {
"enem_user": {
"user_id": 1,
"user_name": "João dos Santos",
"user_first_name": "João",
"user_image": "https://..url-to-image",
},
"enem_quiz": {
"quiz_completed": 30, // percentage %
"quiz_url": "https://..url-to-quiz"
},
"enem_courses_doing_bad": [
{
"couse_id": 1,
"course_title": "Biologia",
"course_quiz_performance": 20, // percentage %
"course_quiz_correct": 1,
"course_quiz_total": 5
}
,...
],
"enem_factors_doing_bad": [
{
"factor_id": 1,
"factor_name": "Interpretação de imagens"
},
{
"factor_id": 2,
"factor_name": "Interpretação de mapas"
}
,...
],
"enem_factors_doing_well": [
{
"factor_id": 3,
"factor_name": "Interpretação de textos"
},
{
"factor_id": 4,
"factor_name": "Interpretação de tabela, gráfico ou infográfico"
}
,...
]
}
}
|
Obter vídeos de revisão de uma matéria
Retorna vídeos de revisão do ENEM do usuário (precisa estar habilitado).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/enem/get-videos |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)course_id ID do Curso (matéria)factor_id opcional - ID do Fator (está indo mal), se informado sobrescreve o ID do Curso
|
| Objetos retornados: |
ENEM em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"ENEM": {
"enem_title": "Biologia",
"enem_videos": [
{
"video_title": "Aminoácidos",
"video_subject": "Bioquímica",
"video_image": "https://..url-to-image"
"video_url": "https://..url-to-video",
"video_embed": "https://..url-to-embed",
"video_difficulty": "Média"
}
,...
]
}
}
|
Eventos
Obter lista de eventos
Retorna lista de eventos disponíveis para um usuário (corporativo).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/event/get-events |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)event_id opcional - filtra por um ID de eventocompany_id opcional - para filtrar pelo ID da empresa (caso tenha autorização)
|
| Objetos retornados: |
EVENTS em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"EVENTS": [
{
"event_id": 1,
"event_title": "Título do Evento",
"event_description": "Descrição do evento...",
"event_image": "https://..url-to-image",
"event_image_dark": "https://..url-to-image",
"event_teacher": {
"teacher_id": 1,
"teacher_name": "Fabrício John",
"teacher_image": "https://..url-to-image"
},
"event_type": "live",
"event_date": "2024-04-26 08:50:00",
"event_video": {
"video_main": {
"main_video_url": "https://..url-to-video",
"main_video_embed": "HTML code to embed",
"main_video_live": "URL to live broadcast"
},
"video_secondary": {
"secondary_video_url": "https://..url-to-video"
"secondary_video_embed": "HTML code to embed",
"main_video_live": "URL to live broadcast"
}
},
"event_forum": {
"forum_id": 1,
"forum_question": {
"question_id": 9821,
"question_title": "Text here..."
}
}
}
,...
]
}
|
eBooks
Obter eBooks do usuário
Retorna lista de eBooks disponíveis para o usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/ebook/get-ebooks |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)
|
| Objetos retornados: |
EBOOKS em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"EBOOKS": [
{
"ebook_id": 3,
"ebook_title": "Como obter maior retorno com treinamentos online",
"ebook_description": "Neste eBook você vai aprender como...",
"ebook_url": "https://...url-to-ebook",
"ebook_purchase_id": 198822,
"ebook_purchase_date": "2024-01-10 10:02:00"
}
,...
]
}
|
Biblioteca Virtual
Obter categorias da biblioteca da empresa
Retorna lista de categorias da biblioteca virtual da empresa.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/library/get-categories |
| Parâmetros: |
token Token de acesso a API
|
| Objetos retornados: |
CATEGORIES em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"CATEGORIES": [
{
"category_id": 7,
"category_title": "Relatórios Digitais"
},
{
"category_id": 120,
"category_title": "Vídeos"
}
,...
]
}
|
Obter itens da biblioteca do usuário
Retorna lista de objetos da biblioteca virtual disponíveis para o usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/library/get-library |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)category_id opcional - para filtrar por uma categoria da bibliotecafavorites opcional - informe true para filtrar somente pelos favoritos do usuário
|
| Objetos retornados: |
LIBRARY em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"LIBRARY": [
{
"item_id": 95,
"item_category_id": 7,
"item_category_title": "Relatórios Digitais",
"item_title": "Relatório de Resultados Semestral",
"item_image": "https://...url-to-image",
"item_file": "https://...url-to-file-download",
"item_type": "pdf",
"item_date": "2024-02-27 08:27:00",
"item_favorite_count": 2,
"item_favorite": true
}
,...
]
}
|
Registra item como favorito
Registra item como favorito na biblioteca do usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/library/set-favorite |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)item_id ID do item da Biblioteca
|
| Objetos retornados: |
SUCCESS em caso de sucesso, esta será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Item registrado como favorito!"
}
|
Remove item dos favoritos
Remove item dos favoritos da biblioteca do usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/library/del-favorite |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)item_id ID do item da Biblioteca
|
| Objetos retornados: |
SUCCESS em caso de sucesso, esta será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Item removido dos favoritos!"
}
|
Metas e Objetivos
Obter metas de um usuário
Retorna lista de metas/objetivos de um usuário específico.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/goal/get-goals |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)goal_id opcional - filtra por uma meta e retorna o objeto user_summary para comparação |
| Objetos retornados: |
GOALS em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"GOALS": [
{
"goal_id": 1,
"goal_title": "Comprometimento para Liderança",
"goal_description": "Meta definida para alcançar nível de liderança na empresa",
"goal_conclusion_date": "2024-03-25",
"goal_metrics": {
"goal_score": 90,
"goal_commitment": 90,
"goal_engagement": 90
},
"goal_badges": [
{
"badge_id": 8,
"badge_title": "Adaptação e Enfrentamento",
"badge_image": "https://...url-to-image"
},
...
],
"user_summary": {
"user_metrics": {
"user_score": 80,
"user_commitment": 70,
"user_engagement": 75
},
"user_badges_already": [
{
"badge_id": 8,
"badge_title": "Adaptação e Enfrentamento",
"badge_image": "https://...url-to-image"
},
...
],
"user_badges_needs": [
{
"badge_id": 9,
"badge_title": "Capacidade de Execução",
"badge_image": "https://...url-to-image"
},
...
]
}
}
,...
]
}
|
Obter ações de PDI de um usuário
Retorna ações adicionais do PDI (Plano de Desenvolvimento Individual) definido pela empresa.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/goal/get-pdi |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)
|
| Objetos retornados: |
PDI em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"PDI": [
{
"pdi_id": 1,
"pdi_description": "Fazer Curso de Liderança",
"pdi_conclusion_date": "2024-12-25"
}
,...
]
}
|
Trilhas de conhecimento
Obter trilhas
Retorna lista de trilhas da empresa ou de um usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/trail/get-trails |
| Parâmetros: |
token Token de acesso a APIquery opcional - pesquisa trilhas pelo Títulouser_id opcional - pesquisa trilhas de um Usuáriotrail_id opcional - pesquisa trilha por IDcourse_id opcional - pesquisa trilhas que contenham o ID do cursoall_formats opcional - Informe true se desejar retorna todos os formatos de cursos (não somente vídeo por padrão)
|
| Objetos retornados: |
TRAILS em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"TRAILS": [
{
"trail_id": 1,
"trail_title": "Título da Trilha do Conhecimento",
"trail_objective": "Objetivo da trilha",
"trail_conclusion_date": "2019-03-25 12:00:00",
"trail_conclusion_message": "Esses cursos fazem parte da Trilha de Conhecimento definida pelo seu gestor e você precisa concluir todos os cursos dessa trilha até do dia 25/03/2019.",
"trail_courses": [
{
"course_trail_order": 1,
"course_trail_available": 1, // flag 0 ou 1
"course_trail_message": "",
// + conteúdo do objeto "COURSES"
},
{
"course_trail_order": 2,
"course_trail_available": 0, // flag 0 ou 1
"course_trail_message": "Esse curso só vai estar disponível após...",
// + conteúdo do objeto "COURSES"
}
,...
]
}
,...
]
}
|
Criar uma trilha
Efetua cadastro de uma nova trilha para a empresa.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/trail/set-trail |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)title Título para a Trilhacourses Lista de Cursos para a Trilha (ex.: 864,1260,2458)goal opcional - Objetivo para a Trilha
|
| Observação importante: | Este endpoint verifique se o usuário possui um "plano ilimitado" liberado; Caso o usuário ainda não o tenha, efetue a liberação antes usando o endpoint de matrícula. |
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Trilha criada com sucesso!"
}
|
Excluir uma trilha
Remove uma trilha inteira, bloqueando os cursos que possuir.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/trail/del-trail |
| Parâmetros: |
token Token de acesso a APItrail_id o ID da Trilha (precisa ter sido criada por sua empresa)
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Trilha excluída com sucesso!"
}
|
Profissões
Obter profissões
Retorna a lista de profissões, podendo ser informados filtros de busca.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/profession/get-professions |
| Parâmetros: |
token Token de acesso a APIquery opcional - para filtrar/buscar por Títuloinclude_courses opcional - para incluir os cursos nos resultados, caso contrário veja Obter cursos de uma profissão
|
| Objetos retornados: |
PROFESSIONS em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"PROFESSIONS": [
{
"profession_id": 4,
"profession_title": "Administrador",
"profession_description": "Descrição aqui...",
"profession_slug": "slug-aqui...",
"profession_icon": "https://../url-da-imagem",
"profession_color": "#fc6455"
}
,...
],
"PROFESSIONS_ALL": [
{
"profession_id": 27,
"profession_title": "Outra Profissão",
"profession_description": "Descrição aqui...",
"profession_slug": "slug-aqui..."
}
,...
]
}
|
Obter cursos de uma profissão
Retorna a lista de de cursos de uma profissão, podendo ser informados filtros de busca.
Nota: Utilize o método Obter lista de cursos, informando o parâmetro profession_id.
Processo de Estudo
Utilizado para manusear os dados de um curso do usuário.
Obter ambiente do curso (sala de aula)
Retorna a URL de acesso à sala de aula personalizada (podendo ser escolhido o layout).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/get-environment |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriocourse_id ID do Cursocourse_layout Layout do Curso (use "0" para exibir somente o vídeo do curso; "1" para exibir vídeo + botões próximo/anterior; "2" para exibir vídeo + botões + tópicos)expire_url_minutes opcional - use para adicionar validade (em minutos) a URL de acesso à sala de aula.topic_index o Índice do Tópico que deseja visualizar, caso não seja informado será retomado da última parte vista
|
| Objetos retornados: |
ENVIRONMENT em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"ENVIRONMENT": {
"course_id": 54828,
"course_company_id": 1,
"course_title": "Curso de 3D Game Studio na Prática",
"course_iframe_url": "https://../url-to-embed-iframe",
"course_user": {
"user_id": 1,
"user_course_completed": 55,
"user_course_grade": 70, // aproveitamento em %
"user_course_topic_index": 25,
"user_course_time_elapsed": 3600,
"user_course_date_lastaccess": "2018-08-10 18:00:00",
"user_course_date_conclusion": ""
}
}
}
|
Obter resumo do curso do usuário (porcentagem, último acesso, etc.)
Retorna o sumário de um curso do aluno.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/get-summary |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoriacourse_id ID do Curso
|
| Objetos retornados: |
SUMMARY em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"SUMMARY": {
"course_id": 54828,
"course_company_id": 1,
"course_title": "Curso de 3D Game Studio na Prática",
"course_user": {
"user_id": 1,
"user_course_completed": 55,
"user_course_grade": 70, // aproveitamento em %
"user_course_topic_index": 25,
"user_course_time_elapsed": 3600,
"user_course_date_start": "2018-08-09 10:00:00",
"user_course_date_lastaccess": "2018-08-10 18:00:00",
"user_course_date_conclusion": ""
}
}
}
|
Obter anexos do curso
Retorna a lista de anexos de um curso.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/get-attachments |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoriacourse_id ID do Curso
|
| Observação Importante: |
|
| Objetos retornados: |
TOPICS em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno 1 (JSON): |
{
"TOPICS": [
{
"topic_index": 1,
"topic_id": 154,
"topic_title": "Título do tópico...",
"topic_image": "https://../url-da-imagem",
"topic_type": 0,
"topic_completed": 1,
"topic_has_attachment": 0,
"topic_percentage": 0,
"topic_attachments": [
{
"attach_id": 2,
"attach_name": "Título do anexo...",
"attach_format": "pdf",
"attach_url": "https://../url-to-file"
},
{
"attach_id": 5,
"attach_name": "Título do anexo...",
"attach_format": "pdf",
"attach_url": "https://../url-to-file"
}
]
},
{
"topic_index": 8,
"topic_id": 256,
"topic_title": "Título do tópico...",
"topic_image": "https://../url-da-imagem",
"topic_type": 0,
"topic_completed": 1,
"topic_has_attachment": 0,
"topic_percentage": 7,
"topic_attachments": [
{
"attach_id": 18,
"attach_name": "Título do anexo...",
"attach_format": "pdf",
"attach_url": "https://../url-to-file"
}
]
}
,...
]
}
|
Obter lista de tópicos do curso
Retorna a lista de tópicos de um curso.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/get-topics |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoriacourse_id ID do Cursoinclude_reflections opcional - para incluir Reflexões na árvore de tópicos do cursoinclude_reactions opcional - para incluir as Avaliações de Reações (se houverem) na árvore de tópicos do curso
|
| Observação Importante: |
|
| Objetos retornados: |
TOPICS em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno 1 (JSON): |
{
"TOPICS": [
{
"topic_index": 1,
"topic_id": 154,
"topic_title": "Título do tópico...",
"topic_image": "https://../url-da-imagem",
"topic_type": 0,
"topic_completed": 1,
"topic_has_attachment": 1,
"topic_percentage": 0,
"topic_format": "video"
},
{
"topic_index": 2,
"topic_id": 192,
"topic_title": "Título do tópico...",
"topic_image": "https://../url-da-imagem",
"topic_type": 0
"topic_completed": 1,
"topic_has_attachment": 0,
"topic_percentage": 8,
"topic_format": "text"
},
{
"topic_index": 3,
"topic_id": 192,
"topic_title": "Atividade Reflexiva - Publicar",
"topic_image": "https://../url-da-imagem",
"topic_type": 7
"topic_completed": 0,
"topic_has_attachment": 0,
"topic_percentage": 30,
"topic_format": "reflection"
}
,...
{
"topic_index": 4,
"topic_id": 192,
"topic_title": "Atividade Reflexiva - Comentar",
"topic_image": "https://../url-da-imagem",
"topic_type": 8
"topic_completed": 0,
"topic_has_attachment": 0,
"topic_percentage": 40,
"topic_format": "reflection"
}
,...
{
"topic_index": 5,
"topic_id": 1211,
"topic_title": "Avaliação Final",
"topic_image": "https://../url-da-imagem",
"topic_type": 1
"topic_completed": 0,
"topic_has_attachment": 0,
"topic_percentage": 95,
"topic_format": "form"
}
]
}
|
| Exemplo de retorno 2 (JSON): |
{
"ERROR": "Curso não liberado para este usuário.",
"STATE": 2,
"FORM": {
"title": "Para ter acesso a esse curso você precisa ter um plano premium.\n\nTenha acesso ilimitado a todos os cursos por 1 ano.\n\nApenas R$ 0,00.",
"field_1": "Nome",
"field_2": 'CPF',
"field_3": "N.º do Cartão",
"field_4": "Validade (MM/AA)",
"field_5": 'CVV',
"submit": "https://../url-para-envio"
}
}
Nota 1: Nota 2: |
Marcar tópico como lido
Efetua marcação num tópico do curso do usuário, como tópico visto.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/set-read |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoriacourse_id ID do Cursotopic_index Índice do Tópico (importante: utilize o Índice, não o ID)time_elapsed Tempo decorrido (em segundos) assistindo o vídeo (ex.: 180)include_reflections opcional - para incluir Reflexões na árvore de tópicos do cursoinclude_reactions opcional - para incluir as Avaliações de Reações (se houverem) na árvore de tópicos do curso
|
| Observação Importante: |
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Tópico marcado como lido!"
}
|
Obter perguntas/respostas de um tópico
Retorna lista de perguntas (formulário) de um tópico do curso.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/get-form |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoriacourse_id ID do Cursotopic_index Índice do Tópico do formulário retornado na Listagem de tópicos (importante: utilize o Índice, não o ID)include_reflections opcional - para incluir Reflexões na árvore de tópicos do cursoinclude_reactions opcional - para incluir as Avaliações de Reações (se houverem) na árvore de tópicos do curso
|
| Observações Importantes: |
|
| Objetos retornados: |
TOPIC em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno 1 (JSON): |
{
"TOPIC": {
"topic_index": 4,
"topic_id": 1211,
"topic_title": "Avaliação Final",
"topic_type": 1,
"topic_completed": 0,
"topic_has_attachment": 0,
"topic_percentage": 95,
"topic_questions": [
{
"question_id": 2552,
"question_type": 2,
"question_title": "Título da questão...",
"question_answer_type": 1,
"question_alt_a": "Alternativa A",
"question_alt_b": "Alternativa B",
"question_alt_c": "Alternativa C",
"question_alt_d": "Alternativa D",
"question_alt_e": "Alternativa E"
},
{
"question_id": 2553,
"question_type": 2,
"question_title": "Título da questão...",
"question_answer_type": 1,
"question_alt_a": "Alternativa A",
"question_alt_b": "Alternativa B",
"question_alt_c": "Alternativa C",
"question_alt_d": "Alternativa D",
"question_alt_e": "Alternativa E"
},
{
"question_id": 2554,
"question_type": 2,
"question_title": "Título da questão...",
"question_answer_type": 2, // resposta dissertativa (exibir campo texto)
"question_alt_a": "",
"question_alt_b": "",
"question_alt_c": "",
"question_alt_d": "",
"question_alt_e": ""
}
,...
]
}
}
|
| Exemplo de retorno 2 (JSON): |
{
"ERROR": "Você precisa visualizar todos os tópicos anteriores antes de responder a Avaliação Final."
}
|
Postar respostas de um formulário
Submete as respostas do formulário, de um tópico do curso, para correção.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/set-form |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoriacourse_id ID do Cursotopic_index Índice do Tópico (importante: utilize o Índice, não o ID)responses um objeto JSON das respostas (veja exemplo abaixo)include_reflections opcional - para incluir Reflexões na árvore de tópicos do cursoinclude_reactions opcional - para incluir as Avaliações de Reações (se houverem) na árvore de tópicos do curso
|
| Exemplo de 'responses': | [
{
"question_id": 2552,
"question_response": 3 // 1 até 5, representa "A" até "E"
},
{
"question_id": 2553,
"question_response": 1 // 1 até 5, representa "A" até "E"
},
...
]
|
| Observações Importantes: |
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal
|
| Exemplo de retorno 1 (JSON): |
{
"STATE": 3,
"SUCCESS": "Avaliação registrada com sucesso!",
"TOPIC_NEXT": 4,
"QUESTIONS": {
"percentage": 75,
"question_responses": ["a","b","d","c"],
"user_responses": ["a","b","d","a"]
}
}
|
| Exemplo de retorno 2 (JSON): |
{
"STATE": 1,
"SUCCESS": "Curso concluído com sucesso!"
}
|
| Exemplo de retorno 3 (JSON): |
{
"STATE": 2,
"ERROR": "Você não obteve a média mínima na Avaliação Final. Alguns tópicos precisam ser revistos no curso.",
"TOPIC_NEXT": 17,
"TOPICS": [
{
"topic_index": 17,
"topic_id": 53619,
"topic_title": "Título do primeiro tópico marcado para rever...",
"topic_type": 0,
"topic_completed": 0,
"topic_has_attachment": 0,
"topic_image": "https://../url-da-imagem"
},
{
"topic_index": 21,
"topic_id": 55011,
"topic_title": "Título do segundo tópico marcado para rever...",
"topic_type": 0,
"topic_completed": 0,
"topic_has_attachment": 0,
"topic_image": "https://../url-da-imagem"
}
,...
]
}
|
Postar pesquisa de satisfação (final do curso)
Submete as resposta do formulário da pesquisa de satisfação.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/set-survey |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoriacourse_id ID do Cursoresponses um objeto JSON com as respostas (veja exemplo abaixo)
|
| Exemplo de 'responses': | {
"recommend": 1, // "1" para "Sim"; "0" para "Não"
"quality": 5, // 1 até 5, nota para "Conteúdo do Curso"
"interactions": 5, // 1 até 5, nota para "Interações no Curso"
"activities": 5, // 1 até 5, nota para "Atividades Extras"
"notifications": 5, // 1 até 5, nota para "Notificações/SMS"
"rewards": 5, // 1 até 5, nota para "Programa de Recompensa"
"artificial_intelligence": 5, // 1 até 5, nota para "Inteligência Artificial"
"video": 5, // 1 até 5, nota para "Qualidade HD do Vídeo"
"comment": "Very good course, Thank you" // comentário livre
}
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Pesquisa registrada com sucesso!"
}
|
Zerar/cancelar um curso
Reseta ou cancela (para corporativo) um curso do aluno.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/set-reset |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoriacourse_id ID do Cursoaction opcional - informe 1 (default) para zerar e 2 para cancelar (específico do corporativo)comment opcional - informe o motivo do cancelamento do curso (obrigatório quando ação for cancelar)
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Curso zerado com sucesso!"
}
|
Obter lista de alunos online no curso
Retorna lista de usuários que estão fazendo o curso.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/course/get-users |
| Parâmetros: |
token Token de acesso a APIcourse_id ID do Curso
|
| Objetos retornados: |
USERS em caso de sucesso, isto será uma lista de usuários
|
| Exemplo de retorno (JSON): |
{
"USERS": [
{
"user_id": 1,
"user_name": "Camila B.",
"user_first_name": "Camila",
"user_image": "https://../url-to-image",
}
,...
]
}
|
Relatórios
Relatório de desempenho do usuário
Retorna lista de cursos (agrupados por categorias) e a performance do usuário em cada um.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/report/get-performance |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoria
|
| Objetos retornados: |
REPORT em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"REPORT": [
{
"category_id": 1,
"category_title": "Título da Categoria",
"category_courses": [
{
"course_id": 54828,
"course_title": "Curso de 3D Game Studio...",
"course_user_completed": 100,
"course_user_grade": 78
}
,...
]
}
,...
]
|
Relatório de desenvolvimento do usuário
Retorna dados de desempenho do usuário agrupado por seções e fatores comportamentais.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/report/get-development |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoria
|
| Objetos retornados: |
REPORT em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"REPORT": {
"report_chart": {
"chart_image": "https://...url-to-image",
"chart_faq": [
{
"faq_title": "Como funciona o gráfico?",
"faq_description": "O gráfico (radar) analisa as principais..."
},
{
"faq_title": "Como são analisados?",
"faq_description": "Usando algoritmos avançados de análise..."
},
{
"faq_title": "Entendendo o gráfico",
"faq_description": "Quando mais próximo do centro..."
},
]
},
"report_user": {
"user_score": 80,
"user_engagement": 75
"user_performance": 81,
"user_commitment": 70,
"user_report_faq": "Texto..."
},
"report_behavioral": [
{
"behavioral_title": "Liderança e Decisão",
"behavioral_summary": "Menos provável que você tenha essa característica",
"behavioral_description": "Esses comportamentos são importantes em cargos...",
"behavioral_average": 4,
"behavioral_courses": [
{
"course_id": 1,
"course_title": "Título do Curso...",
"course_image": "https://...url-to-image"
}
,...
]
}
,...
]
}
|
Certificados
Obter certificados (Cursos e Trilhas finalizadas)
Retorna a lista de certificados disponíveis para um usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/certificate/get-certificates |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuário (logado)user_token Token Privado do Usuário (logado) |
| Objetos retornados: |
COURSES em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"COURSES": [
{
"course_id": 391,
"course_company_id": 1,
"course_date_conclusion": "2018-04-16 09:26:47",
"course_date_start": "2018-03-28 14:01:02",
"course_time_elapsed": 72000,
"course_title": "Curso de Espanhol - Básico",
"course_certificate_pdf": "https://../link-certificado", // no caso do cpf existir
"course_certificate_personalized": "https://../link-certificado-personalizado", // se existir certificado personalizado
"course_user_cpf_exists": 1 // 1 ou 0, existe ou não
}
,...
"TRAILS": [
{
"trail_id": 37,
"trail_title": "Nome da trilha",
"trail_courses": "id_curso_lista",
"trail_start": "0000-00-00 00:00:00",
"trail_conclusion": "2024-07-24 14:16:36",
"trail_certificate_pdf": "https://../link-certificado"
}
,...
]
}
Nota: |
Obter certificados de uma Lista de Usuários
Retorna a lista de certificados disponíveis para uma lista de usuários (agrupado por usuário).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/certificate/get-certificates-grouped |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuário - inteiro ou lista* - o usuário precisa estar associado à sua empresa* Para enviar uma lista de ID's de usuários, no campo "user_id", você pode utilizar o modelo convencional de array em POST. Exemplo de query-string: user_id[]=1&user_id[]=2... |
| Objetos retornados: |
USERS em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"USERS": [
{
"user_id": 391,
"user_name": "João da Silva",
"user_email": "[email protected]",
"user_certificates": [
{
"course_id": 1,
"course_company_id": 1,
"course_date_conclusion": "2018-04-16 09:26:47",
"course_date_start": "2018-03-28 14:01:02",
"course_time_elapsed": 72000,
"course_title": "Curso de Espanhol - Básico",
"course_certificate_pdf": "https://../link-certificado", // no caso do cpf existir
"course_certificate_personalized": "https://../link-certificado-personalizado", // se existir certificado personalizado
"course_user_cpf_exists": 1 // 1 ou 0, existe ou não
}
,...
]
},
{
"user_id": 501,
"user_name": "Amanda Santos",
"user_email": "[email protected]",
"user_certificates": [
{
"course_id": 1,
"course_company_id": 1,
"course_date_conclusion": "2019-04-16 09:26:47",
"course_date_start": "2019-03-28 14:01:02",
"course_time_elapsed": 72000,
"course_title": "Curso de Física",
"course_certificate_pdf": "https://../link-certificado", // no caso do cpf existir
"course_certificate_personalized": "https://../link-certificado-personalizado", // se existir certificado personalizado
"course_user_cpf_exists": 1 // 1 ou 0, existe ou não
}
,...
]
}
,...
]
}
Nota: |
Obter detalhes de um certificado
Retorna os detalhes de um certificado (número) de um aluno.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/certificate/get-details |
| Parâmetros: |
token Token de acesso a APIcertificate_number o Número do certificado
|
| Objetos retornados: |
CERTIFICATE em caso de sucesso, utilize este objeto para manusear os detalhes
|
| Exemplo de retorno (JSON): |
{
"CERTIFICATE": {
"certificate_number": 391,
"certificate_date_start": "2018-03-28 14:01:02",
"certificate_date_conclusion": "2018-04-16 09:26:47",
"certificate_time_elapsed": 72000,
"certificate_user_name": "Nome do Aluno",
"certificate_course_title": "Curso de Espanhol - Básico"
}
}
|
Obter declarações (somente iPED)
Retorna a lista de declarações disponíveis para um usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/certificate/get-declarations |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuário (logado)user_token Token Privado do Usuário (logado) |
| Objetos retornados: |
DECLARATIONS em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"DECLARATIONS": [
{
"declaration_label": "Declaração de...",
"declaration_items": [
{
"course_id": 391,
"course_company_id": 1,
"course_date_conclusion": "2018-04-16 09:26:47",
"course_date_start": "2018-03-28 14:01:02",
"course_time_elapsed": 72000,
"course_title": "Espanhol - Básico",
"course_declaration_price": "29,90",
"course_declaration_request_link": "https://...link-to-payment"
}
,...
]
}
,...
]
}
Nota: |
Reuniões/Aulas
Obter reuniões onde o aluno participa
Retorna a lista de reuniões/aulas onde o aluno foi convidado a participar.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/meeting/get-meeting |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuário (logado)user_token Token Privado do Usuário (logado) - isto é usado para verificar a autoriameeting_id opcional - ID da Reunião, para filtrar por uma reunião específica
|
| Objetos retornados: |
MEETING em caso de sucesso, este objeto retornará a lista de reuniões/aulas
|
| Exemplo de retorno (JSON): |
{
"MEETING": [
{
"meeting_id": 79,
"meeting_company_id": 1,
"meeting_type": 1, // 1 = reuniao, 2 = aula
"meeting_format": 1, // 1 = online, 2 = presencial
"meeting_date": "2020-09-08 12:00:00",
"meeting_duration": "00:30:00",
"meeting_title": "Reunião do Departamento Financeiro",
"meeting_instructions": "Instruções/descrição da reunião fornecida pela empresa (opcional)",
"meeting_has_questions": 1, // 1 = sim, 0 = nao
"meeting_qrcode_mandatory": 0, // 1 = sim, 0 = nao
"meeting_user_invite_date": "2020-09-08 10:00:00",
"meeting_user_presence_status": 1, // confirmou presenca
"meeting_user_presence_date": "2020-09-08 11:55:00",
"meeting_user_questions_status": 0, // nao respondeu questoes
"meeting_user_questions_date": "0000-00-00 00:00:00"
}
,...
]
}
|
Marcar presença numa reunião/aula
Marca presença numa reunião/aula que o aluno foi convidado. Caso já tenha marcado presença anteriormente, não sobrescreve a data.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/meeting/set-presence |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuário (logado)user_token Token Privado do Usuário (logado) - isto é usado para verificar a autoriameeting_id ID da Reunião
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Presença registrada com sucesso!"
}
|
Obter formulário de questões da reunião/aula
Retorna a lista de questões de uma reunião específica.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/meeting/get-form |
| Parâmetros: |
token Token de acesso a APImeeting_id o ID da Reunião
|
| Objetos retornados: |
QUESTIONS em caso de sucesso, este objeto retornará a lista de questões do quizz
|
| Exemplo de retorno (JSON): |
{
"QUESTIONS": [
{
"question_id": 2552,
"question_title": "Título da questão...",
"question_alt_a": "Alternativa A",
"question_alt_b": "Alternativa B",
"question_alt_c": "Alternativa C",
"question_alt_d": "Alternativa D",
"question_alt_e": "Alternativa E"
},
{
"question_id": 2553,
"question_title": "Título da questão...",
"question_alt_a": "Alternativa A",
"question_alt_b": "Alternativa B",
"question_alt_c": "Alternativa C",
"question_alt_d": "Alternativa D",
"question_alt_e": "Alternativa E"
}
,...
]
}
|
Postar respostas de um formulário da reunião/aula
Envia a lista de respostas de um formulário da reunião.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/meeting/set-form |
| Parâmetros: |
token Token de acesso a APImeeting_id o ID da Reuniãouser_id o ID do Usuário (logado)user_token Token Privado do Usuário (logado) - isto é usado para verificar a autoriaresponses um objeto JSON das respostas (veja exemplo abaixo)
|
| Exemplo de 'responses': | [
{
"question_id": 2552,
"question_response": 3 // 1 até 5, representa "A" até "E"
},
{
"question_id": 2553,
"question_response": 1 // 1 até 5, representa "A" até "E"
},
...
]
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Respostas registradas com sucesso!"
}
|
Fórums (Perguntas & Respostas)
Obter lista de fórums
Retorna a lista de fórums (grupos de estudo) disponíveis.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/forum/get-forums |
| Parâmetros: |
token Token de acesso a APIuser_id opcional - apenas Fórums de um Usuáriocourse_id opcional - Fórum associado com um Cursoforum_id ID do Fórum/Grupo opcional se informado, sobescreve o course_idquery opcional - Efetua uma busca pelo título do fórumpage opcional - número da página atual, padrão = 1
|
| Objetos retornados: |
FORUMS em caso de sucesso, utilize este objeto para manusear o resultados (máximo 20 resultados por página)TOTAL_PAGES total de páginas (para paginação)CURRENT_PAGE número da página atual (para paginação) |
| Exemplo de retorno (JSON): |
{
"TOTAL_PAGES": 37,
"CURRENT_PAGE": 1,
"FORUMS": [
{
"forum_id": 1,
"forum_title": "Forum Título (same course title)",
"forum_description": "Descrição aqui...",
"forum_image": "https://../url-da-imagem",
"forum_members": 856,
"forum_course": {
"course_id": 1
}
}
,...
]
}
|
Obter questões de um fórum
Retorna a lista de perguntas num fórum (grupo de estudo).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/forum/get-questions |
| Parâmetros: |
token Token de acesso a APIcourse_id ID do Cursoforum_id ID do Fórum/Grupo opcional se informado, sobescreve o course_iduser_id opcional - se informado, retornará as últimas questões deste Usuário e descartará o parâmetro course_idhas_answers opcional - para retornar apenas perguntas que tenham respostaspage opcional - número da página atual, padrão = 1
|
| Objetos retornados: |
QUESTIONS em caso de sucesso, utilize este objeto para manusear o resultados (max. 20 resuls per page)TOTAL_PAGES total de páginas (para paginação)CURRENT_PAGE número da página atual (para paginação) |
| Exemplo de retorno (JSON): |
{
"TOTAL_PAGES": 1,
"CURRENT_PAGE": 1,
"QUESTIONS": [
{
"question_id": 1,
"question_title": "Sobre texturas...",
"question_description": "Como funciona o sistema de textura desse software?",
"question_last_response": "2018-09-28 20:50:09",
"question_views": 3,
"question_responses": 0,
"question_user": {
"user_id": 1,
"user_name": "Jonas Sampaio",
"user_firstname": "Jonas",
"user_image": "https://../url-da-imagem"
}
}
,...
]
}
|
Postar uma questão
Submete uma nova pergunta num fórum (grupo de estudo).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/forum/set-question |
| Parâmetros: |
token Token de acesso a APIcourse_id ID do Cursouser_id o ID do Usuário (logado)user_token Token Privado do Usuário (logado) - isto é usado para verificar a autoriatitle Título da Questãoquestion Texto da Questão
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal |
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Pergunta postada com sucesso!"
}
|
Remover an question
Efetua exclusão de uma pergunta num fórum (grupo de estudo).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/forum/del-question |
| Parâmetros: |
token Token de acesso a APIquestion_id ID da Questãouser_id o ID do Usuário (logado) - isto é usado para verificar a autoriauser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoria
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal |
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Pergunta removida com sucesso!"
}
|
Obter respostas de uma questão
Retorna lista de respostas de uma pergunta num fórum (grupo de estudo).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/forum/get-answers |
| Parâmetros: |
token Token de acesso a APIquestion_id ID da Questão
|
| Objetos retornados: |
QUESTION questionANSWERS answers
|
| Exemplo de retorno (JSON): |
{
"QUESTION": {
"question_id": 1,
"question_title": "Título da questão...",
"question_description": "Conteúdo da questão...",
"question_last_response": "2018-09-28 20:50:09",
"question_views": 3,
"question_responses": 0,
"question_user": {
"user_id": 1,
"user_name": "Jonas Sampaio",
"user_firstname": "Jonas",
"user_image": "https://../url-da-imagem"
},
"ANSWERS": [
{
"answer_id": 2,
"answer_text": "Título da resposta...",
"answer_best_response": 0,
"answer_date": "2016-07-19 19:30:04",
"answer_teacher_id": 0,
"answer_user": {
"user_id": 1,
"user_name": "Ana Santos",
"user_name_first": "Ana",
"user_image": "https://../url-da-imagem"
}
}
,...
]
}
|
Votar (útil / não útil) numa questão
Submete uma marcação (útil ou não útil) numa resposta do fórum (grupo de estudo).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/forum/set-vote |
| Parâmetros: |
token Token de acesso a APIanswer_id ID da Respostavote para identificar seu Voto: use "1" para "Útil" e "-1" para "Não Útil"
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal |
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Voto registrado com sucesso!"
}
|
Postar uma resposta
Submete uma nova resposta à uma pergunta do fórum (grupo de estudo).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/forum/set-answer |
| Parâmetros: |
token Token de acesso a APIquestion_id ID da Questãouser_id o ID do Usuário (logado)user_token Token Privado do Usuário (logado) - isto é usado para verificar a autoriaanswer Texto da Resposta
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal |
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Resposta postada com sucesso!"
}
|
Remover uma resposta
Efetua a exclusão de uma resposta no fórum (grupo de estudo).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/forum/del-answer |
| Parâmetros: |
token Token de acesso a APIanswer_id ID da Respostauser_id o ID do Usuário (logado) - isto é usado para verificar a autoriauser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoria
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal |
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Resposta removida com sucesso!"
}
|
Anotações
Obter anotações de um tópico do curso
Retorna a lista de anotações previamente feitas num tópico do curso.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/note/get-notes |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoriatopic_id ID do Tópico (do curso)
|
| Objetos retornados: |
NOTES em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"NOTES": [
{
"note_id": 1,
"note_text": "Conteúdo da nota...",
"note_time": "00:00:05",
"note_time_seconds": 5
}
,...
]
}
|
Obter anotações de um curso (agrupado por tópicos)
Retorna a lista de anotações de um curso inteiro.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/note/get-notes-course |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoriacourse_id ID do Curso
|
| Objetos retornados: |
TOPICS em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"COURSE": {
"course_id": 2,
"course_title": "Título do curso...",
"course_image": "https://../url-da-imagem"
},
"TOPICS": [
{
"topic_id": 1,
"topic_title": "Título do tópico...",
"topic_notes": [
{
"note_id": 1,
"note_text": "Conteúdo da nota...",
"note_time": "00:00:05",
"note_time_seconds": 5
},
{
"note_id": 2,
"note_text": "Conteúdo da nota...",
"note_time": "00:00:20",
"note_time_seconds": 20
}
,...
]
}
,...
]
}
|
Obter cursos que contenham anotações
Retorna a lista de cursos de um usuário que contenham anotações.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/note/get-courses |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoria
|
| Objetos retornados: |
COURSES em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"COURSES": [
{
"course_id": 1,
"course_title": "Título do curso...",
"course_image": "https://../url-da-imagem",
"course_notes": 15
}
,...
]
}
|
Postar uma anotação
Submete uma nova anotação num tópico do curso.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/note/set-note |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoriacourse_id ID do Cursotopic_id ID do Tópicotime Tempo atual do vídeo (formato HH:MM:SS)text Texto da Anotação (limitado em 140 caracteres) |
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Anotação postada com sucesso!"
}
|
Remover uma anotação
Efetua a exclusão de uma anotação num tópico do curso.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/note/del-note |
| Parâmetros: |
token Token de acesso a APInote_id Nota IDuser_id o ID do Usuário - isto é usado para verificar a autoriauser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoria
|
| Objetos retornados: |
SUCCESS em caso de sucesso, this will be a literal var
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Anotação removida com sucesso!"
}
|
Reflexões
Obter reflexões
Retorna a lista de reflexões de um usuário num curso.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/reflection/get-reflections |
| Parâmetros: |
token Token de acesso a APIuser_id opcional - para filtrar por ID do Usuáriouser_token opcional - User Token (no caso de ter informado o user_id)reflection_id opcional - para filtrar por ID da Reflexãocourse_id opcional - para filtrar por ID do Cursohas_no_comments opcional - para mostrar apenas reflexões sem respostas (informe = "1")has_answers opcional - para retornar apenas perguntas que tenham respostaspage opcional - número da página atual, padrão = 1
all_formats opcional - Informe true se desejar retorna todos os formatos de cursos (não somente vídeo por padrão)
|
| Objetos retornados: |
REFLECTIONS em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"REFLECTIONS": [
{
"reflection_id": 7534,
"reflection_course": 590,
"reflection_topic_index": 5,
"reflection_stage": 1,
"reflection_text": "Conteúdo da reflexão...",
"reflection_date": "2019-04-08 09:21:20",
"reflection_answered": 0,
"reflection_user": {
"user_id": 12345,
"user_name": "Luciano Gomes",
"user_first_name": "Luciano",
"user_image": "https://../url-da-imagem",
"user_image_small": "https://../url-da-imagem"
}
},...
]
}
|
Postar uma reflexão
Submete uma nova reflexão num tópico do curso.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/reflection/set-reflection |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)course_id ID do Cursotopic_index Índice do Tópico (durante o curso)reflection_text Texto da Reflexão
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Reflexão postada com sucesso!"
}
|
Avaliar/Comentar uma reflexão
Submete a avaliação de uma reflexão de terceiro num tópico do curso.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/reflection/set-comment |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)course_id ID do Cursotopic_index Índice do Tópico (durante o curso)reflection_id ID da Reflexãocomment_grammar Nota para Gramática (utilize valores entre 6 ~ 10)comment_perception Nota para Percepção (utilize valores entre 6 ~ 10)comment_understanding Nota para Entendimento (utilize valores entre 6 ~ 10)comment_text Texto do Comentário
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Avaliação postada com sucesso!"
}
|
Mensagens
Obter mensagens recebidas
Retorna a lista de mensagens recebidas agrupadas por usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/message/get-inbox |
| Parâmetros: |
token Token de acesso a APIuser_id - ID do Usuário (logado)user_token - Token do Usuário (logado)unread_count opcional - para retornar quantidade de mensagens não lidaslimit opcional - para limitar quantidade de registrospage opcional - número da página atual, padrão = 1
|
| Objetos retornados: |
DIALOGUES em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"CONVERSATIONS": [
{
"conversation_id": 12345,
"conversation_unread": true,
"conversation_description": "Como está indo no curso?",
"conversation_date": "2024-03-18 10:00:00",
"conversation_user": {
"user_id": 12345,
"user_name": "Luciano Gomes",
"user_first_name": "Luciano",
"user_image": "https://...url-to-image.."
}
}
,...
]
}
|
Obter conversa com outro usuário
Retorna a lista de mensagens de uma conversa com outro usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/message/get-conversation |
| Parâmetros: |
token Token de acesso a APIuser_id - ID do Usuário (logado)user_token - Token do Usuário (logado)conversation_id - ID da conversa
|
| Objetos retornados: |
MESSAGES em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"MESSAGES": [
{
"message_description": "Como está indo no curso?",
"message_date": "2024-03-18 10:00:00",
"message_user": {
"user_id": 12345,
"user_name": "Luciano Gomes",
"user_first_name": "Luciano",
"user_image": "https://...url-to-image.."
}
},
{
"message_description": "Eu gostei. Mas tive dificuldade na etapa de 60%. Perguntei no Fórum sobre isso.",
"message_date": "2024-03-18 10:20:00",
"message_user": {
"user_id": 56789,
"user_name": "João Silva",
"user_first_name": "João",
"user_image": "https://...url-to-image.."
}
}
,...
]
}
|
Remover conversa com outro usuário
Remove uma conversa inteira que teve com outro usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/message/del-conversation |
| Parâmetros: |
token Token de acesso a APIuser_id - ID do Usuário (logado)user_token - Token do Usuário (logado)conversation_id - ID da conversa
|
| Objetos retornados: |
SUCCESS em caso de sucesso, esta será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Conversa removida com sucesso!"
}
|
Postar uma mensagem
Registra nova mensagem numa conversa com outro usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/message/set-message |
| Parâmetros: |
token Token de acesso a APIuser_id - ID do Usuário (logado)user_token - Token do Usuário (logado)conversation_id - ID da conversamessage - Mensagem (texto)
|
| Objetos retornados: |
SUCCESS em caso de sucesso, esta será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Mensagem enviada com sucesso!"
}
|
Ranking
Obter ranking - Todo o período
Retorna a lista usuários (top 10) do ranking geral.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/ranking/get-ranking-alltime |
| Parâmetros: |
token Token de acesso a APIuser_id opcional - para filtrar por um usuário específicouser_only opcional - para retornar somente ranking do usuário ou o Top 10
|
| Objetos retornados: |
RANKING em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"RANKING": [
{
"user_position": 1,
"user_id": 1,
"user_points": 116688,
"user_name": "Jonas Sampaio",
"user_image": "https://../url-da-imagem",
"user_level": {
"level_name": "Gran Mestre",
"level_image": "https://../url-da-imagem"
}
}
,...
]
}
|
Obter ranking - Somente mês atual
Retorna a lista usuários (top 10) do ranking mensal.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/ranking/get-ranking-month |
| Parâmetros: |
token Token de acesso a APIuser_id opcional - para filtrar por um usuário específicouser_only opcional - para retornar somente ranking do usuário ou o Top 10
|
| Objetos retornados: |
RANKING em caso de sucesso, utilize este objeto para manusear o resultadosMONTH nome do mês
|
| Exemplo de retorno (JSON): |
{
"MONTH": "Outubro",
"RANKING": [
{
"user_position": 1,
"user_id": 1,
"user_points": 116688,
"user_name": "Jonas Sampaio",
"user_image": "https://../url-da-imagem",
"user_level": {
"level_name": "Gran Mestre",
"level_image": "https://../url-da-imagem"
}
}
,...
]
}
|
Obter ranking de um usuário numa competição - Mês atual
Retorna um sumário para montagem de competição comparando com um usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/ranking/get-competition |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuário
|
| Objetos retornados: |
COMPETITION em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"COMPETITION": {
"summary": {
"min_points": 0,
"max_points": 17000,
"max_points_formatted": "17.000",
"day_start": "01/04",
"day_finish": "30/04"
},
"user": {
"id": 123,
"name": "Patricia",
"photo": "https://../url-da-imagem",
"points": 0,
"points_formatted": "0"
},
"friends": {
"1": {
"id": 211,
"name": "André",
"photo": "https://../url-da-imagem",
"points": 1900,
"points_formatted": "1.900"
},
"2": {
"id": 912,
"name": "Luan",
"photo": "https://../url-da-imagem",
"points": 0,
"points_formatted": "0"
},
"3": {
"id": 581,
"name": "Pedro",
"photo": ""https://../url-da-imagem",
"points": 300,
"points_formatted": "300"
}
}
}
}
|
Criar relação de amizade numa competição
Insere novo usuário como amigo numa competição de ranking.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/ranking/set-competition |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado)friend_email E-mail do Amigo (precisa ser de alguém registrado no Sie Edtech, caso contrário retornará um erro - exemplo 2)friend_id opcional - ID do Amigo (caso não informe o E-mail, e deseje informar diretamente um ID)friend_number Número do Amigo no Ranking para trocar (1, 2 ou 3)
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal
|
| Exemplo de retorno 1 (JSON): |
{
"SUCCESS": "Amigo atualizado com sucesso!"
}
|
| Exemplo de retorno 2 (JSON): |
{
"ERROR": "Nenhum usuário encontrado com este e-mail"
}
|
Programa de Incentivo
Obter resgates/vouchers de um usuário
Retorna a lista de resgates ou vouchers já disponíveis para um usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/reward/get-rewards |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoriamonth opcional - use "1" para exibir somente do mês atual
|
| Objetos retornados: |
REWARDS em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"REWARDS": [
{
"reward_id": 1,
"reward_title": "Ingresso Cinema",
"reward_description": "Descrição aqui...",
"reward_date": "2018-10-01",
"reward_image": "https://../url-da-imagem",
"reward_redeemed": 1,
"reward_code": "xyz",
"reward_pdf": "https://../url-para-pdf"
},
{
"reward_id": 2,
"reward_title": "Ingresso Cinema",
"reward_description": "Descrição aqui...",
"reward_date": "2018-10-01",
"reward_image": "https://../url-da-imagem",
"reward_redeemed": 0
}
,...
]
}
|
Resgatar um prêmio/voucher
Submete resgate de prêmio ou voucher para um usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/reward/set-redeem |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoriareward_id ID do Prêmiotype Tipo do Prêmio, use "1" para Cinemark e "2" para Cinepolis
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literal
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Prêmio resgatado com sucesso!"
}
|
Obter lista de prêmios disponíveis e condições
Retorna a lista de prêmios disponíveis no Programa de Incentivo.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/reward/get-items |
| Parâmetros: |
token Token de acesso a API
|
| Objetos retornados: |
ITEMS em caso de sucesso, utilize este objeto para manusear o resultados
|
| Exemplo de retorno (JSON): |
{
"WARNING": "Mensagem de aviso, quando o Programa de Incentivo não está habilitado para o aluno. Quando preenchido, os atributos ITEMS e RULES virão como lista vazia.",
"HOWWORK": "Explicação de como funciona o Programa de Incentivo.",
"RULES": [
"Precisa ter no mínimo 2.000 pontos",
"Premiados apenas o 1º e 2º colocado",
...
],
"ITEMS": [
{
"item_id": 1,
"item_title": "1 Ingresso de Cinema",
"item_image": "https://../url-da-imagem",
"item_position": 2,
"item_condition": "1º lugar do ranking do mês. O prêmio é creditado no mês seguinte.",
},
,...
]
}
|
Obter lista de níveis do programa de incentivo
Lista os níveis do programa de incentivo com seus atributos.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/reward/get-levels |
| Parâmetros: |
token Token de acesso a API
|
| Objetos retornados: |
LEVELS em caso de sucesso, retornará lista de níveis do programa
|
| Exemplo de retorno (JSON): |
{
"LEVELS": [
{
"level_name": "Aço",
"level_image": "https://.../url-to-image",
"level_points": 3000,
"level_benefits": []
},
{
"level_name": "Bronze",
"level_image": "https://.../url-to-image",
"level_points": 7000,
"level_benefits": [
"1 curso premium com carga horária..."
]
},
...
]
}
|
Obter extrato de pontos de um usuário
Retorna a lista pontos conquistados do usuário (somente últimos registros).
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/reward/get-points |
| Parâmetros: |
token Token de acesso a APIuser_id o ID do Usuáriouser_token Token Privado do Usuário (logado) - isto é usado para verificar a autoria
|
| Objetos retornados: |
SUMMARY dados consolidados de pontos do alunoITEMS em caso de sucesso, utilize este objeto para manusear o resultadosINSTRUCTIONS instruções de como se ganha ou perde pontos
|
| Exemplo de retorno (JSON): |
{
"SUMMARY": {
"user_points": 1200,
"user_points_current_month": 500
},
"ITEMS": [
{
"item_description": "Acessou o Curso XYZ...",
"item_date": "2024-02-22",
"item_points": 10
},
,...
],
"INSTRUCTIONS": {
"gain": [
"1.000 pontos ao concluir um curso premium *",
"5 pontos por cada comentário em Atividades Reflexivas relacionadas ao curso **",
...
],
"loss": [
"-15 pontos por errar uma resposta",
"-500 pontos ao prorrogar o curso por 5 dias",
...
]
}
}
|
Cupons
Resgatar um cupom/cartão com Login existente
Resgata um cupom informando E-mail e CPF do usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/coupon/redeem-login |
| Parâmetros: |
token Token de acesso a APIcoupon Cupom/Cartãouser_email E-mail do Usuáriouser_cpf CPF do Usuário
|
| Objetos retornados: |
STATE "0" em caso de erro (quando o cupom é inválido ou erro de preenchimento dos campos)STATE "1" em caso de sucesso (quando usuário existe e o cupom foi resgatado com sucesso; neste caso direcione o usuário para a tela de login)STATE "2" em caso de erro parcial (quando o cupom é válido, mas o usuário não existe; neste caso o cupom não é resgatado, direcione o usuário para a tela de cadastro completo e utilize o método Resgatar um cupom com cadastro)SUCCESS em caso de sucesso, isto será uma mensagem literalITEMS em caso de sucesso, isto retornará os nomes dos cursos ou pacotes resgatados
|
| Exemplo de retorno 1 (JSON): |
{
"STATE": 1,
"SUCCESS": "Cupom resgatado com sucesso!",
"ITEMS": [
"Plano Ilimitado"
],
"USER_COMPANY": {
"company_id": 1,
"company_name": "Nome da Empresa",
"company_url": "https://www.sie.com.br/url-da-empresa",
"company_logo": "https://...url-da-imagem",
"company_header_color": "#ffffff",
"company_categories_id": "",
"company_resources": [
"aulas",
"cursos",
"metas",
"biblioteca",
...
]
}
...
}
|
| Exemplo de retorno 2 (JSON): |
{
"STATE": 2,
"ERROR": "Este E-mail e CPF não foram localizados. Por favor, efetue um cadastro."
}
|
Resgatar um cupom/cartão com Cadastro
Resgata um cupom informando dados de um novo usuário.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/coupon/redeem-signup |
| Parâmetros: |
token Token de acesso a APIcoupon Cupom/Cartãouser_name Nome do Usuáriouser_email E-mail do Usuáriouser_cpf CPF do Usuáriouser_password Senha do Usuário
|
| Objetos retornados: |
STATE "0" em caso de erro (quando o cupom é inválido ou erro de preenchimento dos campos)STATE "1" em caso de sucesso (quando o cadastro foi efetuado e o cupom foi resgatado com sucesso; será retornado todos os dados do usuário para logar automático, similar ao que é retornado no método Login do Usuário)STATE "2" em caso de sucesso (quando usuário já existe e o cupom foi resgatado; neste caso não são retornados os dados para logar automático, direcione o usuário para a tela de login)SUCCESS em caso de sucesso, isto será uma mensagem literalITEMS em caso de sucesso, isto retornará os nomes dos cursos ou pacotes resgatados
|
| Exemplo de retorno 1 (JSON): |
{
"STATE": 1,
"SUCCESS": "Cadastro efetuado e cupom resgatado com sucesso!",
"ITEMS": [
"Curso de Administração",
"Curso de Excel"
],
...
"USER_ID": 1,
"USER_TOKEN": "82e47251b78187e0acbacf185ec",
"USER_TYPE": 3,
"USER_COMPANY": {
"company_id": 1,
"company_name": "Nome da Empresa",
"company_url": "https://www.sie.com.br/url-da-empresa",
"company_logo": "https://...url-da-imagem",
"company_header_color": "#ffffff",
"company_categories_id": "",
"company_resources": [
"aulas",
"cursos",
"metas",
"biblioteca",
...
]
}
...
}
|
| Exemplo de retorno 2 (JSON): |
{
"STATE": 2,
"SUCCESS": "Cupom resgatado com sucesso!",
"ITEMS": [
"Curso de Administração",
"Curso de Excel"
],
"USER_COMPANY": {
"company_id": 1,
"company_name": "Nome da Empresa",
"company_url": "https://www.sie.com.br/url-da-empresa",
"company_logo": "https://...url-da-imagem",
"company_header_color": "#ffffff",
"company_categories_id": "",
"company_resources": [
"aulas",
"cursos",
"metas",
"biblioteca",
...
]
}
...
}
|
Atendimento
Postar um contato
Submete formulário de contato com equipe de atendimento.
| Status: | OPERACIONAL • |
|---|---|
| Endpoint: | /api/support/set-contact |
| Parâmetros: |
token Token de acesso a APIuser_name Nome do Usuáriouser_email E-mail do Usuáriomessage Mensagem
|
| Objetos retornados: |
SUCCESS em caso de sucesso, isto será uma mensagem literalCONTACT em caso de sucesso, isto retornará o número de protocolo
|
| Exemplo de retorno (JSON): |
{
"SUCCESS": "Mensagem enviada com sucesso!",
"CONTACT": {
"contact_id": 123,
"contact_response": "Enviaremos a resposta por e-mail em até 1 dia útil."
}
}
|
© Todos os Direitos Reservados - Sie Edtech
Documento atualizado em 24/04/2025