Publicação de cursos/ações de formação

Link: api/courses/get.json

Devolve informação sobre cursos/ações de formação. A informação devolvida estará restringida pelos filtros definidos no ecrã "Configurações do site" (isto se o parâmetro only_courses = 0 ou não definido).

Parâmetros suportados para filtrar informação:

@param int page: informação relativa a paginação: número da página;
@param int item_per_page: informação relativa a paginação: número de registos por página;
@param bit only_courses: indica se devolve apenas informação dos cursos (ignora ações de formação);
@param string course_type: filtra por tipo de curso;
@param bit web_pub: filtra pelo campo "Pub.Web" na ficha de curso ou ação de formação, dependendo do parâmetro only_courses;
@param bit modules: indica se devolve os módulos de cada ação de formação;
@param bit planning: indica se devolve a planificação dos módulos de cada ação de formação. Apenas funciona se o parâmetro modules for passado com o valor 1;
@param bit trainers: indica se devolve informação sobre os formadores de cada ação de formação;
@param bit tolerances: indica se filtra pelas tolerâncias de inscrições;
@param date evt_start: filtra por ações de formação que iniciam depois desta data. As datas a ter em conta são data de inicio na planificação, e quando esta não está definida, data de inicio da ação definida em candidatura;
@param string keywords: filtro que será aplicado tendo em conta os campos definidos no ecrã "Configurações do site" em "Selecione os campos que pretende que sejam usados na pesquisa de texto livre";
@param bit functions: indica se devolve a informação relativa às funções associadas a cada ação de formação.
@param date updated_since: quando passada, apenas são devolvidos os cursos que foram alterados a partir daquela data. Se omisso ou null, esta validação não é efetuada. O formato deve ser YYYY-mm-dd HH:mi.

Quando se usa esta funcionalidade (solicitar apenas cursos alterados a partir daquela data), aconselha-se a efetuar, pelo menos uma vez por dia, uma chamada a este método (durante uma hora com pouco trafégo - geralmente à noite), para atualização de todos os cursos. Isto porque este método não tem em conta informação de dados eliminados.
@param bit cf_courses: indica que deve devolver os campos de utilizador referentes ao curso

Configurações do site

Este método devolve a seguinte informação:

campo	designação	tabela
course_id	id do curso	courses
course_code	código do curso no humantrain	courses
course	designação do curso	courses
area_code	código da área (da tabela de áreas do humantrain) associado ao curso	courses
area	designação da área	courses
duration_effect	duração do curso em horas	courses
edition	edição do curso
course_type	código do tipo de curso
course_type_description	designação do tipo de curso
mode_code	código da modalidade de curso
mode_code_description	designação da modalidade do curso