Pular para o conteúdo principal
Guia para desenvolvedores
Disponível agora
Professional (plano)

Crie suas próprias integrações com API keys

Puxe horas trabalhadas para seu dashboard de BI, envie os dados de ponto para sua planilha de folha ou conecte o SVDY a qualquer outra coisa com um script de 30 linhas. Chaves com escopo por organização — rotacionáveis e registradas em auditoria a cada chamada.

O que você pode fazer

Ganhos desde o primeiro dia. Sem desenvolvimento: um administrador de PME configura.

Escopo no seu tenant

Cada chave carrega seu organization ID. Uma chave do seu tenant nunca pode ler dados de outro cliente, mesmo se compartilhada acidentalmente. Defesa em profundidade, não só uma checagem de permissão.

Rotacione sem downtime

Gere a nova chave primeiro, faça deploy dos serviços para usá-la, depois revogue a antiga. SVDY permite múltiplas chaves ativas por organização — rotação graciosa, sem janelas de manutenção.

Acesso de escrita controlado por plano

Os planos Free e Starter não têm acesso à API — toda chamada é recusada. Professional e Enterprise têm acesso completo: criar, rotacionar e excluir chaves. O plano é verificado em cada requisição, então um script nunca faz mais do que ele permite.

Configure em 4 passos

Tempo estimado: menos de 5 minutos para um administrador com as credenciais em mãos.

1

Abra Integrações → API e chaves

Você vê suas chaves ativas (truncadas para os últimos 4 chars), data de criação, último uso e ações de rotação / revogação.

2

Clique "Criar chave" → nomeie pelo consumidor

Use nomes como "Script de backup" ou "Dashboard BI" para logs de auditoria legíveis. SVDY mostra a chave completa UMA VEZ — copie agora; não dá para recuperar depois.

3

Use a chave como Bearer token

Envie-a como `Authorization: Bearer svdy_live_...` em cada requisição à API pública (`https://api.svdy.com/v1/public`). A chave já identifica sua organização — nenhum outro cabeçalho é necessário.

curl -H 'Authorization: Bearer svdy_live_xxx...' \
     https://api.svdy.com/v1/public/me
# The key identifies your organization — no other header needed.
4

Configure alertas de rotação

Cada chave mostra "last_used_at". Logs de auditoria em /system/audit-logs registram cada chamada. Boa prática: rotacione a cada 90 dias, revogue chaves não usadas há 30 dias.


Pronto para conectar?

Abra a administração da sua organização → Integrações e conecte esta integração em menos de 5 minutos.