Biblioteca REST

@rewritetoday/rest e o cliente de baixo nivel da Rewrite para times que precisam de controle direto do comportamento HTTP. Repositorio: github.com/RewriteToday/rest

Quando usar

Quando voce quer controle explicito de request/response.
Quando precisa customizar retry e timeout.
Quando roda em serverless/edge e precisa controlar budget de execucao.
Quando ja possui sua propria camada de abstracao e so precisa do transporte.

Capacidades principais

Helpers de rota

Use builders do @rewritetoday/types para evitar erros de montagem de path.

Controle de retry

Trate falhas transientes e respostas de rate limit com backoff customizado.

Estrategia de timeout

Configure limites de timeout compatveis com seu runtime.

Hooks

Adicione observabilidade, logging e instrumentacao de request/response.

Instalacao

npm install @rewritetoday/rest @rewritetoday/types

pnpm add @rewritetoday/rest @rewritetoday/types

yarn add @rewritetoday/rest @rewritetoday/types

bun add @rewritetoday/rest @rewritetoday/types

Exemplo basico

import { REST } from '@rewritetoday/rest';
import { Routes, type RESTGetWebhookData } from '@rewritetoday/types';

const rewrite = new REST({
  timeout: 12_000,
  secret: process.env.REWRITE_API_KEY,
});

const { data } = await rewrite.get<RESTGetWebhookData>(Routes.webhooks.get('123'));

console.log({ data });

Exemplo de resiliencia

import { REST } from '@rewritetoday/rest';
import { Routes } from '@rewritetoday/types';

const rewrite = new REST({
  timeout: 12_000,
  secret: process.env.REWRITE_API_KEY,
  retry: {
    max: 5,
    delay(attempt) {
      return Math.min(8_000, 2 ** attempt * 250);
    },
  },
  onRateLimit(context) {
    console.log({ context });
  },
});

await rewrite.post(Routes.messages.create(), 
  {
    to: '+5511999999999',
    content: 'Seu codigo de verificacao e 382991',
  },
  {
  	headers: {
    	'Idempotency-Key': 'msg_382991',
   	}
  }
);

Boas praticas

Mantenha API keys apenas no servidor

Nunca exponha chaves da Rewrite em frontend, apps mobile ou repositorios publicos.

Use idempotencia em operacoes de escrita

Envie chaves de idempotencia em acoes de criacao/envio para evitar duplicacoes em retries.

Alinhe com @rewritetoday/types

Combine @rewritetoday/rest com @rewritetoday/types para manter paths e contratos sincronizados.

Adicione observabilidade cedo

Registre latencia, classes de status e contagem de retry para detectar saturacao cedo.

Visao geral

Adapters

Themes

Pacotes

Biblioteca REST

Quando usar

Capacidades principais

Helpers de rota

Controle de retry

Estrategia de timeout

Hooks

Instalacao

Exemplo basico

Exemplo de resiliencia

Boas praticas

Documentacao relacionada

Biblioteca Types

Erros e retries

​Quando usar

​Capacidades principais

Helpers de rota

Controle de retry

Estrategia de timeout

Hooks

​Instalacao

​Exemplo basico

​Exemplo de resiliencia

​Boas praticas

​Documentacao relacionada

Biblioteca Types

Erros e retries

Quando usar

Capacidades principais

Instalacao

Exemplo basico

Exemplo de resiliencia

Boas praticas

Documentacao relacionada