Un paquete npm para 128 APIs de datos

dataandapis es el cliente oficial de JavaScript y TypeScript del catálogo. Cada API es una propiedad del cliente y cada endpoint es un método tipado, así que tu editor completa la llamada y nunca armas una URL a mano.

npm install dataandapis
  • Versión 0.1.0
  • Licencia MIT
  • Sin dependencias
  • import y require
  • Node.js 18 o posterior
index.ts
import { DataAndApis } from "dataandapis";

// reads DATAANDAPIS_API_KEY from the environment
const client = new DataAndApis();

const check = await client.vat.validateVatNumber({
  vat: "IE6388047V",
});

console.log(check.valid, check.name);
// true "GOOGLE IRELAND LIMITED"

Instalación

npm install dataandapis

Con otro gestor de paquetes:

pnpm add dataandapis
yarn add dataandapis
bun add dataandapis

Inicio rápido

Crea una cuenta gratuita y genera una clave en tu panel. El plan Free incluye 500 tokens al mes y no pide tarjeta; la mayoría de las llamadas cuesta 1 token. Consigue una clave gratuita →

Módulos ES y TypeScript
import { DataAndApis } from "dataandapis";

const client = new DataAndApis({ apiKey: process.env.DATAANDAPIS_API_KEY });

const check = await client.vat.validateVatNumber({ vat: "IE6388047V" });
console.log(check.valid, check.name); // true "GOOGLE IRELAND LIMITED"
CommonJS
const { DataAndApis } = require("dataandapis");

const client = new DataAndApis({ apiKey: process.env.DATAANDAPIS_API_KEY });

client.vat.validateVatNumber({ vat: "IE6388047V" }).then((check) => {
  console.log(check.valid, check.name);
});

Si no pasas apiKey, el cliente lee la variable de entorno DATAANDAPIS_API_KEY.

Cómo se nombran las llamadas

La propiedad es la dirección de la API en este sitio en camelCase: /apis/barcode-lookup es client.barcodeLookup. El método es el nombre del endpoint: Lookup By Barcode es lookupByBarcode.

Los parámetros de ruta y de consulta van en un solo objeto. Un cuerpo JSON va en body.

// GET /v1/products/{barcode}: the path parameter goes in the object
const product = await client.barcodeLookup.lookupByBarcode({ barcode: "3017620422003" });

// Query parameters go in the same object
const result = await client.sanctions.screenName({ name: "Viktor Bout", min_score: 0.85 });

// POST: the JSON body goes in "body"
const batch = await client.sanctions.screenNamesBatch({
  body: { names: ["Viktor Bout", "Acme Trading LLC"] },
});

Cada página de API muestra la llamada exacta de cada uno de sus endpoints, lista para copiar.

Errores

Todo fallo es una instancia de DataAndApisError, con una clase para cada caso.

ClaseCuándo
AuthenticationError401: falta la clave o no es válida
PaymentRequiredError402: la suscripción tiene un pago pendiente; paymentUrl trae el enlace para pagar
QuotaExceededError429: se agotaron los tokens del mes
ApiErrorCualquier otro estado de error, como 400 o 404
TimeoutErrorNo hubo respuesta dentro del tiempo de espera
ConnectionErrorLa petición nunca recibió respuesta
import { ApiError, DataAndApis, QuotaExceededError } from "dataandapis";

try {
  await client.barcodeLookup.lookupByBarcode({ barcode: "0000000000000" });
} catch (err) {
  if (err instanceof QuotaExceededError) {
    // upgrade the plan or wait for the monthly reset
  } else if (err instanceof ApiError && err.status === 404) {
    console.log("Not in the catalogue:", err.message);
  } else {
    throw err;
  }
}

Reintentos, tiempos de espera y saldo de tokens

Las peticiones GET se reintentan hasta dos veces tras un error de red o una respuesta 408, 502, 503 o 504. Las peticiones POST y las respuestas 429 nunca se reintentan. Cada intento tiene un tiempo de espera de 30 segundos. Ambos valores se pueden cambiar para el cliente o para una sola llamada. Las llamadas fallidas no consumen tokens.

Cada respuesta informa cuántos tokens le quedan a tu clave, y onResponse recibe ese número.

const client = new DataAndApis({
  timeout: 30_000, // milliseconds per attempt
  maxRetries: 2,   // retries for GET requests
  onResponse: ({ api, status, tokensRemaining }) => {
    if (tokensRemaining !== undefined && tokensRemaining < 50) console.warn("Running low on tokens");
  },
});

// Or for one call
await client.vat.validateVatNumber({ vat: "FR40303265045" }, { timeout: 45_000, maxRetries: 0 });

Endpoints que devuelven un archivo

Los endpoints de imágenes y documentos devuelven un Blob.

import { writeFile } from "node:fs/promises";

const png = await client.qrCodeGenerator.generateQrCode({ data: "https://dataandapis.com", size: 400 });
await writeFile("qr.png", Buffer.from(await png.arrayBuffer()));

TypeScript

Los tipos vienen dentro del paquete. Los tipos de respuesta se infieren de una respuesta de ejemplo por endpoint, así que tómalos como guía: un campo puede ser null o faltar con otras entradas. Pasa tu propio tipo como argumento de tipo cuando necesites uno más estricto.

interface Holiday {
  date: string;
  name: string;
}

const next = await client.publicHolidays.nextHolidays<{ holidays: Holiday[] }>({ country: "MX" });

// Every parameter and response type is exported
import type { VatValidateVatNumberParams, VatValidateVatNumberResponse } from "dataandapis";

Dónde funciona

Node.js 18 o posterior; las pruebas corren en Node.js 18, 20, 22 y 25. El paquete solo necesita el fetch integrado, así que Bun, Deno y Cloudflare Workers también deberían funcionar, aunque no forman parte de las pruebas.

Llama a las APIs desde tu servidor. No envían cabeceras CORS, así que el navegador bloquea las peticiones hechas desde una página web, y una clave en el código del front-end quedaría a la vista de cualquier visitante.

Las 128 APIs del paquete

La versión 0.1.0 cubre 128 APIs y 529 endpoints. Busca una API para ver su nombre en el cliente.

¿No usas JavaScript?

Todas las APIs son REST con una cabecera X-Api-Key, así que sirve cualquier cliente HTTP. Cada página de API tiene ejemplos en Python, PHP y Go y un documento OpenAPI 3.1.