Skynova Admin API — Documentação

Skynova Admin API v1 · OpenAPI 3

⚠️ Modo de testes ativo — os botões “Testar” executam chamadas REAIS em PRODUÇÃO ().

Documentação no padrão OpenAPI 3 ·

Obter chave da API

Requisitos para utilização

Para consumir a API você precisa de duas informações:

Chave privada do ambiente — obtida no Painel de Controle. Vem codificada em base64 e precisa ser decodificada antes de assinar o JWT.
Token público do usuário (jti) — retornado por POST /auth/login com o usuário e a senha do Painel de Controle.

Onde obter a chave privada

No Painel de Controle, siga o caminho:

Menu Superior Direito → Configurações da Conta → Interface API → Chave Privada

Abrir o Painel de Controle

Autenticação (JWT)

A API usa JWT (assinatura HS256). Com a chave privada e o jti em mãos, monte o token assim:

Faça POST /auth/login e guarde o jti.
Decodifique de base64 a chave privada do ambiente.
Assine, com essa chave, o header { "typ": "JWT", "alg": "HS256" } e o payload { "jti": "…" }.
Envie o token em todas as chamadas no header Authorization: bearer <jwt>.

Gerando o token JWT no seu código

Exemplos prontos para montar a string JWT na sua aplicação:

Testar a API pela documentação

Atenção — ambiente de PRODUÇÃO. As chamadas de teste são executadas de verdade contra e têm efeito real (podem criar, alterar e excluir dados). Use com cuidado.

Informe o jti e a chave privada do ambiente para gerar a string JWT (HS256) e habilitar o botão “Testar” em cada endpoint. A documentação monta o JWT no seu navegador e o envia em Authorization: bearer … nas chamadas.

Ainda não tem a chave privada ou quer entender como gerar o JWT no seu próprio código? Veja .

Obter jti via login (POST /auth/login — chamada em produção)

Validação de Segurança

jti (preenchido após o login ou cole um jti existente) Chave privada do ambiente (base64) — Painel → Configurações → API

JWT gerado (enviado como Authorization: bearer …)

✔ Ativo — os endpoints agora têm o botão “Testar”.

O JWT é gerado no seu navegador (HS256, Web Crypto) e fica apenas nesta aba (sessionStorage). A chave privada não é armazenada nem enviada a nenhum servidor. Use “Limpar credenciais” para encerrar.

Importar documentação

⬇ Baixar OpenAPI 3 (YAML) ⬇ Baixar OpenAPI 3 (JSON)

Carregando documentação…