PhotonGrant API

REST API para integração com a plataforma PhotonGrant. Todas as chamadas requerem autenticação via API key (Bearer token) ou sessão Supabase.

Autenticação

Inclui o header Authorization: Bearer YOUR_API_KEY em todos os pedidos.

Gera a tua API key em Definições → API & Integrações.

GET/api/v1/candidaturas

Listar todas as candidaturas da organização

Auth: Bearer <API_KEY>
Response:
{ "candidaturas": [{ "id", "nome", "incentivo_id", "status", "valor_investimento", "created_at" }] }
POST/api/v1/candidaturas

Criar nova candidatura

Auth: Bearer <API_KEY>
Body:
{ "nome": "Projeto X", "incentivo_id": "SICE-IP-2026", "valor_investimento": 500000 }
Response:
{ "candidatura": { "id", "nome", "status": "draft" } }
GET/api/v1/briefings

Listar briefings da organização

Auth: Bearer <API_KEY>
Response:
{ "briefings": [{ "id", "incentivo_id", "data", "updated_at" }] }
POST/api/v1/briefings

Criar ou atualizar briefing

Auth: Bearer <API_KEY>
Body:
{ "incentivo_id": "SICE-IP-2026", "data": { "emp_nome": "...", "fin_vn_n0": "..." } }
Response:
{ "briefing": { "id", "incentivo_id", "updated_at" } }
POST/api/financial-plan

Gerar plano financeiro (requer autenticação Supabase)

Auth: Session cookie
Body:
{ "action": "generate_plan_smart", "briefing": { ... } }
Response:
{ "success": true, "scenarios": { "pessimista": {...}, "normal": {...}, "otimista": {...} }, "ratios": {...} }
POST/api/ies-extract

Extrair dados financeiros de PDF IES

Auth: Session cookie
Body:
FormData com ficheiro PDF
Response:
{ "data": { "fin_vn_n0": "...", "fin_cmvmc": "...", ... } }

Rate Limits

PhotonGrant by PMEIncentivos