Guias de integração

Guias técnicos

Fluxos práticos para integrar produtos ao ecossistema NEXACT com autenticação, licenciamento, dispositivos, atualizações, releases e operação administrativa.

Guia

SDK NEXACT

Integração recomendada de produtos por meio do SDK oficial da plataforma.

  1. 1Inicialize NexactSdk com produto, versão e canal.
  2. 2Forneça armazenamento e segredo do cofre da plataforma.
  3. 3Consuma os módulos públicos em vez de chamar endpoints diretamente.
  4. 4Inicie sincronização em segundo plano e encerre com destroy().
Guia

Primeiros passos

Sequência recomendada para consumir a plataforma com segurança.

  1. 1Obtenha credenciais NEXACT ID.
  2. 2Use HTTPS e Authorization: Bearer <token>.
  3. 3Consulte /api/v1 para descobrir módulos disponíveis.
  4. 4Use /api/v1/openapi.json como contrato técnico.
  5. 5Registre request id em integrações críticas.
Guia

Fluxo de autenticação

Fluxo de login, refresh token, logout e sessão persistente.

  1. 1Crie uma conta por /api/v1/nexact-id/register.
  2. 2Autentique por /api/v1/nexact-id/login.
  3. 3Renove sessão por /api/v1/nexact-id/session/refresh.
  4. 4Liste sessões por /api/v1/nexact-id/sessions.
  5. 5Revogue sessões no logout ou em dispositivos suspeitos.
Guia

Fluxo de licenciamento

Como produtos validam planos, recursos, validade e limites de uso.

  1. 1Associe usuário, produto e dispositivo.
  2. 2Consulte /api/v1/licensing/validate antes de liberar recurso.
  3. 3Respeite status ACTIVE, TRIAL, EXPIRED, REVOKED e SUSPENDED.
  4. 4Use assinatura server-side da decisão quando disponível.
Guia

Gerenciamento de dispositivos

Registro, atualização e revogação de máquinas autorizadas por conta.

  1. 1Gere identificador único do dispositivo no cliente.
  2. 2Registre em /api/v1/devices.
  3. 3Atualize último acesso e versão do aplicativo.
  4. 4Revogue autorização em caso de troca ou risco.
Guia

Fluxo de atualização

Como releases e downloads devem ser consultados por produtos desktop.

  1. 1Consulte /api/v1/updates/check.
  2. 2Use canal Stable, Beta, Preview ou Development.
  3. 3Leia release notes antes de exibir atualização.
  4. 4Baixe instaladores pela Central de Downloads.
Guia

Fluxo administrativo

Processo administrativo para publicação, auditoria e operação segura.

  1. 1Autentique como perfil administrativo.
  2. 2Valide IAM/RBAC server-side.
  3. 3Use APIs /api/admin/* para mutações.
  4. 4Registre auditoria em alterações críticas.