Instalación y configuración

Instala el SDK de Publiq para Node.js, Python o PHP, crea tu API key y valida la configuración con una primera llamada.

1. Instala el SDK

Los SDKs oficiales son la forma recomendada de usar Publiq — traen tipos, reintentos automáticos e idempotencia. Instala según tu lenguaje:

npm install publiq

pnpm add publiq

yarn add publiq

pip install publiq

composer require publiq/publiq

2. Crea tu API key

En el panel, ve a Ajustes → API Keys y genera una clave. Las claves tienen scope (full o read-only) — usa full para enviar. Guárdala con seguridad: se muestra una sola vez.

3. Configura el entorno

El SDK lee la variable PUBLIQ_API_KEY automáticamente. Defínela en el entorno del servidor (.env, secrets del proveedor, etc.):

PUBLIQ_API_KEY=pk_live_xxxxxxxxxxxxxxxx

Nunca expongas la API key en el frontend (React, mobile, apps client-side). Llama a Publiq siempre desde el servidor — ver las guías de Next.js, NestJS y Express.

4. Valida la configuración

Haz una llamada de lectura para confirmar que la clave funciona (no envía nada):

import { Publiq } from 'publiq';

const publiq = new Publiq(process.env.PUBLIQ_API_KEY);
const { data } = await publiq.templates.list();
console.log('OK —', data.length, 'templates');

curl https://api.publiq.digital/v1/templates \
  -H "Authorization: Bearer $PUBLIQ_API_KEY"

El SDK Node está escrito en TypeScript y trae los tipos de todos los parámetros y respuestas — el autocompletado del editor te guía. Siguiente: Quickstart.