SDKs oficiais

Sua infraestrutura fala a sua linguagem.

Leve a Vertra para os scripts e ferramentas que você já escreve. Clientes oficiais para JavaScript, TypeScript, Python e Go, com métodos tipados e acesso à API da plataforma.

Escolher meu SDK Ler a documentação

JS / TSapp.ts

const app = await client.apps.get("app-id");
await client.apps.restart(app.id);

PYapp.py

app = client.apps.get("app-id")
client.apps.restart(app["id"])

GOmain.go

app, _ := client.Apps.Get(ctx, "app-id")
_, _ = client.Apps.Restart(ctx, app.ID, nil)

JavaScript · TypeScript · Python · GoVertra API

Comece pelo seu código

Três linguagens. A mesma Vertra.

Instale o pacote, conecte sua chave de API e faça a primeira chamada. Os exemplos usam uma variável de ambiente para manter a chave fora do código.

JavaScript / TypeScript

npm

Métodos assíncronos e tipos para desenvolver com autocomplete em JavaScript e TypeScript.

app.ts

import { VertraClient } from "@vertracloud/sdk-api";

const client = new VertraClient({
  apiKey: process.env.VERTRA_API_KEY!,
});

const app = await client.apps.get("app-id");
console.log(app.name);

Python

PyPI

Um cliente síncrono e tipado para seus scripts, bots e ferramentas em Python.

app.py

import os
from vertracloud import VertraClient

client = VertraClient(
    api_key=os.environ["VERTRA_API_KEY"]
)

app = client.apps.get("app-id")
print(app["name"])

Go

pkg.go.dev

Cliente idiomático com context.Context para serviços, CLIs e automações em Go.

main.go

package main

import (
	"context"
	"fmt"
	"log"
	"os"

	"github.com/vertracloud/sdk-api-go/rest"
	"github.com/vertracloud/sdk-api-go/vertracloud"
)

func main() {
	restClient, err := rest.NewClient(os.Getenv("VERTRA_API_KEY"))
	if err != nil {
		log.Fatal(err)
	}
	client := vertracloud.New(restClient)

	app, err := client.Apps.Get(context.Background(), "app-id")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(app.Name)
}

No seu fluxo

Menos HTTP manual. Mais do seu projeto.

Use os mesmos recursos da API pública, organizados em métodos que você encontra no editor.

Aplicações e bancos

Consulte status e métricas, inicie, pare e reinicie recursos a partir do seu código.

Arquivos e snapshots

Leia e atualize arquivos, configure variáveis de ambiente e crie ou restaure snapshots.

Erros que você pode tratar

Identifique autenticação, permissões e limites de requisição com classes de erro próprias.

Workspaces e automações

Integre projetos, membros e papéis aos seus processos. Cada chamada respeita os escopos da sua chave.

Primeira integração

Da instalação à primeira resposta.

Instale o pacote

Use npm, pip ou go get no ambiente do seu projeto, conforme a linguagem.

Crie sua chave

No painel, crie uma chave de API com as permissões necessárias e configure VERTRA_API_KEY no ambiente do seu script.

Conecte os recursos

Informe o ID da aplicação e consulte seus dados. A partir daí, componha as chamadas de que sua automação precisa.

FAQ

Antes da primeira chamada.

Posso usar o SDK JavaScript no navegador?

Use o SDK em um ambiente de servidor. Uma chave de API no navegador fica exposta a quem acessa a página; mantenha as chamadas autenticadas no seu backend.

Os SDKs dão acesso a todo o painel?

Eles cobrem os recursos disponíveis pela API pública e pelos escopos da sua chave. Gestão de chaves, convites e navegação nos dados dos bancos continuam no painel.

Como acompanho minha aplicação?

Consulte status, métricas e logs pelos métodos de apps. O método realtime também permite consumir eventos em tempo real.

Os limites da API continuam valendo?

Sim. As chamadas seguem as permissões e os limites da API da sua conta. Trate os erros de limite de requisição na sua integração.