Integrations

Conecte o CriptEnv a provedores de hospedagem para sincronizar segredos automaticamente. Suportados: Vercel, Railway e Render.

Info

As integrações permitem sincronização bidirecional — você pode enviar segredos do CriptEnv para o provedor (push) ou importar do provedor para o CriptEnv (pull).

post Criar integração

Conecta uma nova integração com um provedor de hospedagem.

ParâmetroTipoDescrição
providerobrigatóriostringProvedor: vercel, railway, render
api_keyobrigatóriostringChave de API do provedor
project_idobrigatóriostringID do projeto no provedor
environmentstringAmbiente alvo no provedor (ex: production)
bash
curl -X POST https://api.criptenv.dev/api/v1/projects/{pid}/integrations \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "vercel",
    "api_key": "vercel_token_xxx",
    "project_id": "prj_abc123",
    "environment": "production"
  }'

get Listar integrações

Retorna todas as integrações configuradas no projeto.

bash
curl https://api.criptenv.dev/api/v1/projects/{pid}/integrations \
  -H "Authorization: Bearer {token}"

get Obter integração

Retorna os detalhes de uma integração específica.

bash
curl https://api.criptenv.dev/api/v1/projects/{pid}/integrations/int_xyz789 \
  -H "Authorization: Bearer {token}"

delete Remover integração

Remove a integração e desfaz a conexão com o provedor.

bash
curl -X DELETE https://api.criptenv.dev/api/v1/projects/{pid}/integrations/int_xyz789 \
  -H "Authorization: Bearer {token}"

post Sincronizar

Executa uma sincronização entre o CriptEnv e o provedor. Use direction: push para enviar segredos ao provedor ou pull para importar.

ParâmetroTipoDescrição
directionobrigatóriostringDireção: push ou pull
bash
curl -X POST https://api.criptenv.dev/api/v1/projects/{pid}/integrations/int_xyz789/sync \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"direction": "push"}'

post Validar integração

Verifica se a conexão com o provedor está funcionando corretamente.

bash
curl -X POST https://api.criptenv.dev/api/v1/projects/{pid}/integrations/int_xyz789/validate \
  -H "Authorization: Bearer {token}"