API y clientes
Autenticación con clave de API en el plan Enterprise: permisos, límites de uso, referencia OpenAPI, clientes de Python y JavaScript y conexión con los SDK de MCP.
Inicio rápido
Cree una clave en el panel, en Ajustes › API, y envíela en cada solicitud en el encabezado Authorization.
curl https://tecrube.com/api/v1/account/me \
-H "Authorization: Bearer tk_your_key"Autenticación y permisos
- La clave empieza por
tk_y solo se muestra una vez, al crearla; únicamente se guarda su hash. - Una clave no puede superar los permisos de quien la creó. Si esa persona deja el equipo, deja de funcionar; si baja su rol, una clave de escritura pasa a lectura.
- Si el plan pierde el acceso a la API, las solicitudes devuelven 402. Cada cuenta admite un máximo de 20 claves activas.
| Permiso | Permite | No permite |
|---|---|---|
| read | Leer todos los datos | Cambiar nada ni iniciar tareas |
| write | Actúa como administrador del espacio; los cambios siguen sus reglas de aprobación | Equipo, contraseña, sesiones, 2FA, plan y pagos |
Límites de uso
- API: 600 solicitudes por minuto por clave.
- Herramientas MCP: 120 llamadas por minuto por clave y 2.000 llamadas por hora por cuenta.
- Al superar el límite se devuelve 429 con el encabezado
Retry-After. Los clientes listos reintentan las lecturas y el 429 por sí solos.
Códigos de error
| Código | Significado |
|---|---|
| 401 | Clave ausente, no válida o revocada |
| 402 | El plan no incluye esta acción |
| 403 | El permiso o el rol no son suficientes |
| 404 | Registro no encontrado |
| 422 | Cuerpo o parámetro no válido |
| 429 | Límite de uso superado |
| 5xx | Problema temporal del servidor; reintente las lecturas |
Referencia OpenAPI
Descargue el documento OpenAPI actualizado de todos los endpoints a los que llega su clave. Impórtelo en Postman o genere clientes para otros lenguajes con openapi-generator.
curl https://tecrube.com/api/v1/api-referansi/openapi.json \
-H "Authorization: Bearer tk_your_key" \
-o tecrube-openapi.jsonClientes listos
Sin dependencias: instale el paquete o añada el archivo único a su proyecto e impórtelo. Incluye REST, herramientas MCP, reintentos y un tipo de error.
pip install tecrubenpm install tecrube- Descargar: tecrube.py (Python 3.9+)
- Descargar: tecrube.mjs · tecrube.d.ts (Node 18+, Deno, Bun)
from tecrube import Tecrube, TecrubeError
client = Tecrube("tk_your_key")
me = client.get("/account/me")
campaigns = client.call_tool("list_campaigns", days=7)
try:
client.post("/account/brands", {"name": "New project"})
except TecrubeError as e:
print(e.status, e.message)import { Tecrube, TecrubeError } from "tecrube";
const client = new Tecrube(process.env.TECRUBE_API_KEY);
const me = await client.get("/account/me");
const campaigns = await client.callTool("list_campaigns", { days: 7 });
try {
await client.post("/account/brands", { name: "New project" });
} catch (e) {
if (e instanceof TecrubeError) console.error(e.status, e.message);
}Conexión con los SDK de MCP
Los SDK oficiales de MCP (TypeScript y Python) se conectan a esta dirección. Si crea su propio asistente o agente, envíe la clave en el encabezado; las aplicaciones que actúan en nombre de otros usuarios usan OAuth 2.1.
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const transport = new StreamableHTTPClientTransport(new URL("https://tecrube.com/mcp"), {
requestInit: { headers: { Authorization: `Bearer ${process.env.TECRUBE_API_KEY}` } },
});
const client = new Client({ name: "my-app", version: "1.0.0" });
await client.connect(transport);
const { tools } = await client.listTools();SDK para apps móviles
Tecrube no tiene un SDK para integrar en su app móvil, ni hace falta. Para medir dentro de la app instale directamente Google Analytics for Firebase, el SDK de Meta y el SDK de TikTok; Tecrube lee sus datos a través de sus cuentas.
Próximos pasos
- Cómo funcionaEl recorrido de un mensaje de chat a través de Tecrube hasta la plataforma publicitaria y de vuelta con seguridad: MCP, OAuth, límites de seguridad, aprobación de sugerencias, registro de auditoría y deshacer.
- Seguridad y aprobaciónEl modelo de seguridad de Tecrube: OAuth 2.1, cambios que se aplican cuando los pides y se pueden deshacer, aprobación de sugerencias, límite de presupuesto, registro de auditoría y resultados que el asistente no puede inventar.
- PlanesLos niveles Inicial, Profesional, Agencia y Empresa: precios mensuales y anuales, créditos incluidos, paquetes adicionales, programa de invitaciones y reglas para cambiar de plan.