Pular para o conteúdo principal
@polymorfa/sdk é o SDK de servidor da Polymorfa para TypeScript e JavaScript. Ele não tem dependências de runtime e inclui as próprias definições de tipo.

Requisitos

  • Node.js 20 ou mais recente, ou um Cloudflare Worker no servidor, Deno ou Bun. O runtime precisa oferecer fetch e crypto.subtle.
  • Uma chave da equipe (pmfa_…) ou uma credencial de projeto (pmfa_pt_…). Crie uma em Chaves de API.
Mantenha as chaves no seu servidor. Código de navegador e de apps móveis usa um token de cliente.

Instale

O SDK é publicado como prerelease de desenvolvimento sob a tag dev. Ainda não existe uma versão estável. A flag de versão exata registra a versão resolvida, como 0.1.0-dev.20261001215108, para que toda instalação receba o mesmo código. Faça commit do seu lockfile. A tag dev muda a cada nova prerelease publicada. Leia as notas de versão antes de atualizar.

Faça sua primeira solicitação

Guarde sua chave na variável de ambiente POLYMORFA_KEY e liste seus Números:
Esta chamada precisa da permissão sessions:read.

Envie uma mensagem

Esta chamada precisa de messages:write. O Número precisa estar conectado. Veja Envie e receba mensagens para mídia, modelos e respostas.

Use um runtime de edge

Importe da raiz do pacote, @polymorfa/sdk, em Cloudflare Workers, Deno e Bun. Guarde as chaves no armazenamento de segredos do runtime, não no código-fonte. @polymorfa/sdk/node contém helpers de download de arquivos que precisam do Node.js. Não importe esse módulo em código de edge. Veja Verifique um webhook para um Worker que recebe webhooks.

Próximos passos