API REST para parceiros

A API permite que parceiros aprovados publiquem vagas, consultem candidaturas e atualizem status programaticamente. Documentação técnica completa.

Autenticação

Todas as requisições requerem o header Authorization: Bearer pv_xxxx_xxxx com uma chave gerada no painel do parceiro.

curl https://portal.italo.br/api/v1/jobs \
  -H "Authorization: Bearer pv_abc12345_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Endpoints

GET/api/v1/jobs

Lista as vagas do parceiro autenticado. Suporta filtros via query string.

GET /api/v1/jobs?status=PUBLISHED&limit=20

POST/api/v1/jobs

Cria uma nova vaga. Status inicial = DRAFT até ser publicada.

POST /api/v1/jobs
Content-Type: application/json

{
  "title": "Estágio em Marketing",
  "description": "Apoio ao time de marketing...",
  "type": "INTERNSHIP",
  "modality": "HYBRID",
  "city": "São Paulo",
  "state": "SP",
  "applyMode": "INTERNAL",
  "salaryMin": 200000,
  "salaryShow": true,
  "courses": ["marketing","administracao"]
}

PATCH/api/v1/jobs/:id

Atualiza uma vaga. Use { status: 'PUBLISHED' } para publicar.

PATCH /api/v1/jobs/clxxxx
{ "status": "PUBLISHED" }

GET/api/v1/applications

Lista candidaturas das vagas do parceiro.

GET /api/v1/applications?jobId=clxxxx&status=RECEIVED

PATCH/api/v1/applications/:id

Atualiza status de uma candidatura.

PATCH /api/v1/applications/clxxxx
{ "status": "INTERVIEWING", "partnerNote": "Marcar entrevista" }

Webhooks

Configure no painel webhooks para os eventos application.created, application.status_changed e job.published. Cada requisição inclui o header X-Portal-Signature com HMAC-SHA256 do payload.