Zum Inhalt springen
Tecrübetecrube.com
Erste Schritte

API und Clients

Authentifizierung per API-Schlüssel im Enterprise-Plan: Berechtigungen, Ratenlimits, OpenAPI-Referenz, Python- und JavaScript-Clients und die Anbindung mit den MCP-SDKs.

Schnellstart

Erstellen Sie im Panel unter Einstellungen › API einen Schlüssel und senden Sie ihn bei jeder Anfrage im Authorization-Header.

bash
curl https://tecrube.com/api/v1/account/me \
  -H "Authorization: Bearer tk_your_key"

Authentifizierung und Berechtigungen

  • Ein Schlüssel beginnt mit tk_ und wird nur einmal bei der Erstellung angezeigt; gespeichert wird nur sein Hash.
  • Ein Schlüssel kann die Rechte der Person, die ihn erstellt hat, nicht überschreiten. Verlässt sie das Team, funktioniert er nicht mehr; sinkt ihre Rolle, fällt ein Schreibschlüssel auf Lesen zurück.
  • Verliert der Plan den API-Zugang, antworten Anfragen mit 402. Pro Konto sind höchstens 20 aktive Schlüssel möglich.
BerechtigungErlaubtNicht erlaubt
readAlle Daten lesenEtwas ändern oder Aufgaben starten
writeHandelt wie ein Workspace-Admin; Änderungen folgen Ihren FreigaberegelnTeam, Passwort, Sitzungen, 2FA, Plan und Zahlung

Ratenlimits

  • API: 600 Anfragen pro Minute je Schlüssel.
  • MCP-Tools: 120 Aufrufe pro Minute je Schlüssel und 2.000 Aufrufe pro Stunde je Konto.
  • Bei Überschreitung kommt 429 mit dem Header Retry-After. Die fertigen Clients wiederholen Lesezugriffe und 429 selbst.

Fehlercodes

CodeBedeutung
401Schlüssel fehlt, ist ungültig oder widerrufen
402Der Plan enthält diese Aktion nicht
403Berechtigung oder Rolle reicht nicht aus
404Eintrag nicht gefunden
422Ungültiger Inhalt oder Parameter
429Ratenlimit überschritten
5xxVorübergehendes Serverproblem; Lesezugriffe wiederholen

OpenAPI-Referenz

Laden Sie das aktuelle OpenAPI-Dokument aller Endpunkte herunter, die Ihr Schlüssel erreicht. Importieren Sie es in Postman oder erzeugen Sie mit openapi-generator Clients für andere Sprachen.

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

Fertige Clients

Keine Abhängigkeiten: als Paket installieren oder die einzelne Datei in Ihr Projekt legen und importieren. Enthält REST, MCP-Tools, Wiederholungen und einen Fehlertyp.

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);
}

Anbindung mit den MCP-SDKs

Die offiziellen MCP-SDKs (TypeScript und Python) verbinden sich mit dieser Adresse. Für einen eigenen Assistenten oder Agenten senden Sie den Schlüssel im Header; Apps, die für andere Nutzer handeln, verwenden 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 für mobile Apps

Tecrube hat kein SDK zum Einbetten in Ihre mobile App und Sie brauchen auch keines. Für die Messung in der App installieren Sie Google Analytics for Firebase, das Meta SDK und das TikTok SDK direkt; Tecrube liest deren Daten über Ihre Konten.

Nächste Schritte