Ferramentas e versões · v1 em prévia

Comece pelo HTTP da sua linguagem.

Os exemplos usam HTTP diretamente. Não há SDK oficial ou coleção de ferramentas para download publicada nesta documentação.

JavaScript no servidor

Defina as duas variáveis de ambiente com os dados confirmados pela equipe. A função abaixo consulta uma página e devolve o envelope para que sua aplicação trate o cursor. O exemplo faz uma única chamada.

JavaScript

export async function listarProdutos() {
  const base = process.env.AKRUS_BASE_URL;
  const token = process.env.AKRUS_API_KEY;
  if (!base || !token) throw new Error("Configure o ambiente Akrus");

  const url = new URL("/api/v1/products", base);
  url.searchParams.set("limit", "50");
  const response = await fetch(url, {
    headers: { Authorization: `Bearer ${token}` },
    cache: "no-store",
    signal: AbortSignal.timeout(10000),
  });
  const body = await response.json();
  if (!response.ok) {
    throw new Error(`Akrus ${response.status}: ${body.error?.code ?? "erro"}`);
  }
  return body;
}

O que sua aplicação precisa acrescentar

Configuração e segurança

Configuração por ambiente e armazenamento seguro da credencial.
Nunca exponha a chave em código entregue ao navegador.
Limites de tentativas e observabilidade sem segredos.

Tratamento e continuidade

Tratamento de timeout, falhas de rede, JSON inesperado e status HTTP.
Paginação, persistência por identificador e reconciliação.
Retentativas de forma controlada.

Como avaliar uma biblioteca de terceiros

Verifique autoria, manutenção e o contrato que a biblioteca implementa. Um pacote com “Akrus” no nome não é automaticamente oficial. Não entregue credenciais a serviços intermediários sem avaliar o acesso que receberão.

Exemplo completo de paginação

Referência conferida em 23 de setembro de 2026. Relatar uma dúvida na documentação.