Pular para o conteúdo principal
SVDY Logo
Guia para desenvolvedores
Disponível agora
Starter tier

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

Puxe horas trabalhadas para seu dashboard de BI, envie presença 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

As primeiras vitórias do dia. Sem necessidade de engenharia para um admin de PME configurar.

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

Plano Starter tem API somente leitura. Professional libera escrita. Enterprise tem chaves ilimitadas + IP allowlist. Reforço na camada de request — sem contas surpresa, sem scripts com permissões demais.

Configure em 4 passos

Tempo estimado: menos de 5 minutos para um admin 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 o admin da sua organização → Integrações e conecte esta integração em menos de 5 minutos.