Documentación preliminar

La API de CES está en diseño. Endpoints, campos y URLs pueden cambiar antes de la primera versión pública.

Referencia · v0 preview

Webhooks

Eventos

Configura un endpoint HTTPS en la consola y elige los eventos que quieres recibir. Eventos previstos:

Evento	Descripción
domain.registered	Un dominio se registró correctamente.
domain.expiring	Un dominio vence en los próximos 30 días.
invoice.created	Se emitió una factura.
sale.created	Se registró una venta en CES Business.
inventory.low	Un producto bajó del mínimo de inventario.

Verificar la firma

Cada entrega incluye la cabecera CES-Signature con un HMAC-SHA256 del cuerpo usando el secreto del endpoint. Verifícala antes de procesar el evento.

import crypto from "node:crypto";

export function verify(body: string, signature: string, secret: string) {
  const expected = crypto.createHmac("sha256", secret).update(body).digest("hex");
  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
}