SDKs oficiales

Tu infraestructura habla tu lenguaje.

Lleva Vertra a los scripts y herramientas que ya escribes. Clientes oficiales para JavaScript, TypeScript, Python y Go, con métodos tipados y acceso a la API de la plataforma.

Elegir mi SDK Leer la documentación

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

Empieza por tu código

Tres lenguajes. La misma Vertra.

Instala el paquete, conecta tu clave de API y realiza la primera llamada. Los ejemplos usan una variable de entorno para mantener la clave fuera del código.

JavaScript / TypeScript

npm

Métodos asíncronos y tipos para desarrollar con autocompletado en JavaScript y 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

Un cliente síncrono y tipado para tus scripts, bots y herramientas en 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 con context.Context para servicios, CLIs y automatizaciones en 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)
}

En tu flujo

Menos HTTP manual. Más de tu proyecto.

Usa los recursos de la API pública mediante métodos que puedes encontrar en tu editor.

Aplicaciones y bases de datos

Consulta estado y métricas, inicia, detén y reinicia recursos desde tu código.

Archivos y snapshots

Lee y actualiza archivos, configura variables de entorno y crea o restaura snapshots.

Errores que puedes gestionar

Identifica autenticación, permisos y límites de solicitudes con clases de error específicas.

Workspaces y automatizaciones

Integra proyectos, miembros y roles en tus procesos. Cada llamada respeta los permisos de tu clave.

Primera integración

De la instalación a la primera respuesta.

Instala el paquete

Usa npm, pip o go get en el entorno de tu proyecto, según el lenguaje.

Crea tu clave

En el panel, crea una clave de API con los permisos necesarios y configura VERTRA_API_KEY en el entorno de tu script.

Conecta tus recursos

Indica el ID de la aplicación y consulta sus datos. Después, combina las llamadas que necesita tu automatización.

FAQ

Antes de la primera llamada.

¿Puedo usar el SDK JavaScript en el navegador?

Usa el SDK en un entorno de servidor. Una clave de API en el navegador queda expuesta a los visitantes; mantén las llamadas autenticadas en tu backend.

¿Los SDKs dan acceso a todo el panel?

Cubren los recursos de la API pública y los permisos de tu clave. La gestión de claves, las invitaciones y la navegación por los datos de las bases siguen en el panel.

¿Cómo superviso mi aplicación?

Consulta estado, métricas y logs con los métodos de apps. El método realtime también permite consumir eventos en tiempo real.

¿Siguen aplicándose los límites de la API?

Sí. Las llamadas respetan los permisos y límites de la API de tu cuenta. Gestiona los errores de límite de solicitudes en tu integración.