DIVISA API / PRODUCCIÓN

Integra desde Node.js y TypeScript

Usa Node.js con fetch y carga DIVISA_API_KEY desde el almacén de secretos de tu servidor. Esta consulta utiliza tasas reales y consume cuota.

cURL
curl --fail-with-body 'https://api.divisa.do/v1/rates?currency=USD&freshness=current&limit=5' \
  -H 'Accept: application/json' \
  -H "Authorization: Bearer $DIVISA_API_KEY"
TypeScript
const response = await fetch(
  'https://api.divisa.do/v1/rates?currency=USD&freshness=current&limit=5',
  { headers: { Accept: 'application/json', Authorization: `Bearer ${process.env.DIVISA_API_KEY}` } }
);

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const { data, meta } = await response.json();
console.log(data);

Lista de integración

  1. Crea una aplicación y una clave para su backend. No expongas el secreto al cliente.
  2. Consulta la moneda, canal y tipo comercial o de referencia que corresponda. Compra y venta son desde la perspectiva de la entidad.
  3. Conserva los valores decimales como texto. Para cálculos usa aritmética decimal; no Number ni parseFloat.
  4. Guarda la tasa elegida, entidad, fuente, fechas y precisión temporal con el resultado. Muestra Divisa como procedencia y permite consultar la fecha.
  5. Si falta un lado, la tasa está vencida o no hay cobertura, muestra la ausencia y permite una decisión explícita. No inventes un valor.
  6. Revisa el request ID en Consumo después de la primera consulta autenticada.

La integración inicial es informativa. Usar tasas para cobros o documentos fiscales requiere una evaluación específica con el responsable del producto.