Integrações que
vivem em padrões,
não em proprietário.

Provedores compatíveis com OpenID Connect

Fluxo OIDC simplificado

# 1. Discovery por domínio (sem auth)
GET https://api.intellicreate.online/api
/api/sso/discover?domain=empresa.com.br
→ { sso: true, provider: "OIDC", init_url: "..." }

# 2. Browser redireciona para o IdP (state, nonce, PKCE)
GET https://api.intellicreate.online/api
/api/sso/oidc/start?tenant_slug=empresa
→ 302 https://login.microsoftonline.com/.../authorize?code_challenge=...

# 3. IdP devolve callback — assinatura do id_token verificada via JWKS
GET https://api.intellicreate.online/api
/api/sso/oidc/callback?code=...&state=...
→ 302 https://<tenant>.intellicreate.online/login/sso-complete#ticket=...

# 4. Frontend troca o ticket de uso único pela sessão (POST /api/sso/exchange)

Sem IdP? Link de acesso pela API

Alternativa ao SSO para quem já tem app ou portal próprio: no clique do aluno, o seu servidor pede um link de uso único (5 minutos, só aluno ativo, só no endereço da sua empresa) e redireciona o navegador. As duas formas convivem.

curl -X POST https://api.intellicreate.online/api
/v1/users/<id>/access-link \
  -H "Authorization: Bearer ik_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "course_id": "<id do curso>" }'
→ 201 { "data": { "url": "https://<empresa>.intellicreate.online/login/acesso#t=...", "expires_at": "..." } }

SCIM 2.0 — provisionamento

Configure seu IdP apontando o connector SCIM para nossa base URL. Token bearer dedicado por tenant (escopo limitado, distinto de API Key).

# Endpoint base
https://api.intellicreate.online/api
/scim/v2

# Exemplo: criar usuário
curl -X POST https://api.intellicreate.online/api
/scim/v2/Users \
  -H "Authorization: Bearer scim_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/scim+json" \
  -d '{
    "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
    "userName": "joao@empresa.com.br",
    "name": { "givenName": "João", "familyName": "Silva" },
    "active": true,
    "title": "Vendedor",
    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
      "department": "Comercial",
      "employeeNumber": "1234"
    }
  }'

Recursos disponíveis

Quickstart

# 1. Criar API Key no painel admin (/admin/integrations)
#    Você verá o fullKey UMA vez — guarde em vault.

# 2. Fazer requisições
curl https://api.intellicreate.online/api
/v1/users?limit=20 \
  -H "Authorization: Bearer ik_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# 3. Criar matrícula em massa (até 1000 por chamada)
curl -X POST https://api.intellicreate.online/api
/v1/enrollments/bulk \
  -H "Authorization: Bearer ik_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "enrollments": [
      { "user_id": "uuid", "course_id": "uuid" },
      { "user_id": "uuid", "course_id": "uuid" }
    ]
  }'

# 4. Verificar certificado publicamente (sem auth)
curl https://api.intellicreate.online/api
/v1/certificates/verify/abc123xyz
→ { "verified": true, "certificate": { ... } }

Eventos publicados

Verificação HMAC do seu lado

import { createHmac, timingSafeEqual } from "node:crypto";

function verifyWebhook(req, secret) {
  const sigHeader = req.headers["x-intellicreate-signature"];
  if (!sigHeader) throw new Error("missing signature");

  const parts = Object.fromEntries(
    sigHeader.split(",").map((p) => p.split("="))
  );
  const t = parseInt(parts.t, 10);
  const v1 = parts.v1;

  // Anti-replay: rejeita signatures de mais de 5 min
  if (Math.abs(Date.now() / 1000 - t) > 300)
    throw new Error("timestamp too old");

  const payload = `${t}.${req.rawBody}`;
  const expected = createHmac("sha256", secret).update(payload).digest("hex");

  if (!timingSafeEqual(Buffer.from(v1), Buffer.from(expected)))
    throw new Error("signature mismatch");

  return true;
}

Política de retries

Rate limits

Headers X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset retornados em todas as respostas. Resposta 429 inclui Retry-After.