Cliente

O @sonder/sdk é o SDK oficial em Node.js/TypeScript para a API v1 do SonderCloud. Ele expõe três recursos principais: apps, databases e account.

Instalação

npm install @sonder/sdk

yarn add @sonder/sdk

pnpm add @sonder/sdk

O SDK depende do fetch global (Node.js 18+). Em runtimes sem fetch nativo, forneça uma implementação customizada via fetch na configuração.

Uso básico

import { SonderCloudSDK } from '@sonder/sdk';

const sonder = new SonderCloudSDK({
  apiToken: process.env.ZENTRAX_API_TOKEN!,
});

const apps = await sonder.apps.list();
console.log(apps);

Também é possível usar o helper createClient, equivalente a new SonderCloudSDK(...):

import { createClient } from '@sonder/sdk';

const sonder = createClient({ apiToken: process.env.ZENTRAX_API_TOKEN! });

Configuração do cliente

string

required

Token de API Bearer do SonderCloud, obtido no painel do usuário. Enviado em toda requisição como Authorization: Bearer <token>.

string

default:"https://api.sondercloud.app"

URL base da API, sem sufixo de versão.

number

default:"30000"

Timeout de cada requisição, em milissegundos. Ao ser excedido, a promise rejeita com um erro informando a URL e o timeout configurado.

object

Cabeçalhos HTTP extras enviados em todas as requisições.

Function

Implementação customizada de fetch. Útil em runtimes sem fetch global.

Se apiToken não for informado, o construtor lança um erro imediatamente (SonderCloudSDK: "apiToken" é obrigatório.).

Exemplo completo

const sonder = new SonderCloudSDK({
  apiToken: 'seu-token',
  baseUrl: 'https://api.custom.lat',
  timeoutMs: 60_000,
  headers: { 'X-Custom-Header': 'valor' },
  fetch: myCustomFetchFunction,
});

Recursos disponíveis

Recurso	Descrição
`sonder.apps`	Deploy, ciclo de vida e arquivos de aplicações.
`sonder.databases`	Criação, ciclo de vida e credenciais de databases.
`sonder.account`	Informações da conta autenticada.

Tratamento de erros

Veja como capturar e diferenciar os erros lançados pelo SDK.

Comece aqui

Aplicações

Databases

Conta

Tratamento de Erros

Instalação

Uso básico

Configuração do cliente

Exemplo completo

Recursos disponíveis

Tratamento de erros

​Instalação

​Uso básico

​Configuração do cliente

​Exemplo completo

​Recursos disponíveis

Tratamento de erros

Instalação

Uso básico

Configuração do cliente

Exemplo completo

Recursos disponíveis