Saltar al contenido
Tecrübetecrube.com
Primeros pasos

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.

bash
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.
PermisoPermiteNo permite
readLeer todos los datosCambiar nada ni iniciar tareas
writeActúa como administrador del espacio; los cambios siguen sus reglas de aprobaciónEquipo, 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ódigoSignificado
401Clave ausente, no válida o revocada
402El plan no incluye esta acción
403El permiso o el rol no son suficientes
404Registro no encontrado
422Cuerpo o parámetro no válido
429Límite de uso superado
5xxProblema 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.

bash
curl https://tecrube.com/api/v1/api-referansi/openapi.json \
  -H "Authorization: Bearer tk_your_key" \
  -o tecrube-openapi.json

Clientes 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.

Python
pip install tecrube
JavaScript
npm install tecrube
Python
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)
JavaScript
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.

TypeScript
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