● REST API — Sandbox

SGE Developer Portal

Integre seus sistemas ao SGE com autenticação por token, filtros dinâmicos e paginação automática.

Base URL: https://api.poscta.com.br/api
Auth: Bearer Token
Endpoints: 5

Autenticação

Bearer Token

Todas as requisições exigem um token no header HTTP. Tokens são gerados individualmente por parceiro e não expiram.

Authorization: Bearer XXXXXXXX-XXXXXXXX-XXXXXXXX

Content-Type: application/json
Accept: application/json

Endpoints

GET /api/cursos Retorna a lista de cursos disponíveis no sistema SGE. ▶
Parâmetros
Response
cURL
▶ Testar

Retorna a lista de cursos disponíveis no sistema SGE.

CampoTipoObrigatórioDescrição
page int opcional Número da página (padrão: 1)
per_page int opcional Itens por página, máximo 100 (padrão: 15)
nome string opcional Filtra pelo nome do curso (busca parcial)
url string opcional Filtra pela URL amigável exata do curso
id string opcional Filtra pelo ID do curso
page int opcional Página (padrão: 1)
per_page int opcional Itens por página, máx 100 (padrão: 15)
JSON — exemplo
{
    "success": true,
    "data": [
        {
            "id": "CS1675W",
            "nome": "MBA em Gestão de Projetos",
            "url": "mba-gestao-projetos"
        },
        {
            "id": "CS2605M",
            "nome": "Pós em Direito Empresarial",
            "url": "pos-direito-empresarial"
        }
    ],
    "pagination": {
        "total": 48,
        "per_page": 15,
        "current_page": 1,
        "last_page": 4,
        "from": 1,
        "to": 15
    }
}
cURL
curl -X GET "https://api.poscta.com.br/api/cursos" \
  -H "Authorization: Bearer SEU-TOKEN-AQUI" \
  -H "Accept: application/json"
Playground — teste ao vivo
Token de acesso
Filtros (query string)
nome
url
id
page
per_page
Resposta
Clique em Enviar para ver a resposta aqui.
POST /api/interessados Cadastra um novo interessado em um curso. Use para enviar leads capturados em landing pages e portais parceiros. ▶
Parâmetros
Request
Response
cURL
▶ Testar

Cadastra um novo interessado em um curso. Use para enviar leads capturados em landing pages e portais parceiros.

CampoTipoObrigatórioDescrição
candidato_id string opcional UUID do candidato (se já existir no sistema)
curso_id string obrigatório ID do curso de interesse (obter via GET /cursos)
nome string obrigatório Nome completo do interessado
email email obrigatório E-mail do interessado
celular string opcional Celular no formato 11999999999 (DDD + número, sem espaços ou traços)
ativo enum opcional Status do registro (padrão: S)
JSON — body
{
    "curso_id": "CS1675W",
    "nome": "João da Silva",
    "email": "joao@email.com",
    "celular": "11999998888"
}
JSON — exemplo
{
    "success": true,
    "message": "Interessado cadastrado com sucesso.",
    "data": {
        "id": 142
    }
}
cURL
curl -X POST "https://api.poscta.com.br/api/interessados" \
  -H "Authorization: Bearer SEU-TOKEN-AQUI" \
  -H "Content-Type: application/json" \
  -d '{"curso_id":"CS1675W","nome":"João da Silva","email":"joao@email.com","celular":"11999998888"}'
Playground — teste ao vivo
Token de acesso
Campos (body JSON)
candidato_id
curso_id *
nome *
email *
celular
ativo
Resposta
Clique em Enviar para ver a resposta aqui.
GET /api/areas Retorna a lista de áreas de conhecimento disponíveis. ▶
Parâmetros
Response
cURL
▶ Testar

Retorna a lista de áreas de conhecimento disponíveis.

JSON — exemplo
{
    "success": true,
    "data": [
        {
            "id": "1",
            "nome": "Saúde"
        },
        {
            "id": "2",
            "nome": "Educação"
        }
    ],
    "total": 2
}
cURL
curl -X GET "https://api.poscta.com.br/api/areas" \
  -H "Authorization: Bearer SEU-TOKEN-AQUI" \
  -H "Accept: application/json"
Playground — teste ao vivo
Token de acesso
Filtros (query string)
Resposta
Clique em Enviar para ver a resposta aqui.
GET /api/concursos Retorna os concursos (processos seletivos) ativos e vigentes. ▶
Parâmetros
Response
cURL
▶ Testar

Retorna os concursos (processos seletivos) ativos e vigentes.

JSON — exemplo
{
    "success": true,
    "data": [
        {
            "id": "uuid-1",
            "nome": "Processo Seletivo 2026\/1",
            "partida": "2026-01-01",
            "termino": "2026-12-31",
            "ativo": "S"
        }
    ],
    "total": 1
}
cURL
curl -X GET "https://api.poscta.com.br/api/concursos" \
  -H "Authorization: Bearer SEU-TOKEN-AQUI" \
  -H "Accept: application/json"
Playground — teste ao vivo
Token de acesso
Filtros (query string)
Resposta
Clique em Enviar para ver a resposta aqui.
GET /api/planos Retorna o plano de pagamento completo para um curso, concurso e duração específicos, incluindo todos os detalhes de vencimento necessários para criar uma inscrição. ▶
Parâmetros
Response
cURL
▶ Testar

Retorna o plano de pagamento completo para um curso, concurso e duração específicos, incluindo todos os detalhes de vencimento necessários para criar uma inscrição.

CampoTipoObrigatórioDescrição
concurso_id string obrigatório ID do concurso (obter via GET /concursos)
curso_id string obrigatório ID do curso (obter via GET /cursos)
JSON — exemplo
{
    "success": true,
    "data": [
        {
            "id": "db030ea2-88cc-4285-aaad-069a7754ba5c",
            "num_parcelas": 24,
            "preco_base": "662.50",
            "preco_venda": "530.00",
            "desconto_percentual": "20.00",
            "ofertar_no_site": "S",
            "taxa_inscricao": "0.00"
        }
    ],
    "total": 1
}
cURL
curl -X GET "https://api.poscta.com.br/api/planos" \
  -H "Authorization: Bearer SEU-TOKEN-AQUI" \
  -H "Accept: application/json"
Playground — teste ao vivo
Token de acesso
Filtros (query string)
concurso_id *
curso_id *
Resposta
Clique em Enviar para ver a resposta aqui.

Códigos de resposta

200Sucesso — GET
201Criado — POST
401Token inválido ou ausente
404Endpoint não encontrado
422Erro de validação
500Erro interno