API de Tu Catálogo

Qué es

El API te deja conectar sistemas externos — un ERP, un programa de inventario, una hoja que ya usa el negocio — con sus productos, líneas, colecciones, blogs y pedidos. Así el negocio no tiene que cargar dos veces lo mismo.

Qué planes lo incluyen

• Free — no incluye API.
• Starter — no incluye API.
• Pro — hasta 2 api keys activas.
• Premium — hasta 5 api keys activas.

Compara todo lo que trae cada uno en Planes →

Cómo generar una api key

La crea alguien con acceso al portal del negocio, en portal.tucatalogo.co:

1. Entra a Configuración → API Keys → Crear.
2. Ponle un nombre que diga para qué es (por ejemplo, "ERP bodega") y elige cuándo vence.
3. Elige los permisos, agrupados por recurso. Marca solo lo que la integración necesita.
4. Copia el secreto y guárdalo en un lugar seguro. Empieza por tcg_ y se muestra una sola vez: si lo pierdes, toca crear otra key.

Una key nunca tiene más permisos que el usuario que la creó. Si a ese usuario le quitan un permiso, la key también lo pierde.

Cómo autenticarte

Manda estos dos headers en cada request:

• X-Tenant-Id: el id del negocio.
• X-Api-Key: el secreto de la key.

curl "https://api.tucatalogo.co/api/<ruta>" \
  -H "X-Tenant-Id: <id-del-negocio>" \
  -H "X-Api-Key: tcg_..."

Cambia <ruta> por la de un endpoint de la referencia de abajo.

Permisos por endpoint

Cada endpoint de la referencia indica el permiso que necesita en el campo x-permission (por ejemplo, product:List). Si la key no tiene ese permiso, el API responde 403.