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.
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.
| Berechtigung | Erlaubt | Nicht erlaubt |
|---|---|---|
| read | Alle Daten lesen | Etwas ändern oder Aufgaben starten |
| write | Handelt wie ein Workspace-Admin; Änderungen folgen Ihren Freigaberegeln | Team, 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
| Code | Bedeutung |
|---|---|
| 401 | Schlüssel fehlt, ist ungültig oder widerrufen |
| 402 | Der Plan enthält diese Aktion nicht |
| 403 | Berechtigung oder Rolle reicht nicht aus |
| 404 | Eintrag nicht gefunden |
| 422 | Ungültiger Inhalt oder Parameter |
| 429 | Ratenlimit überschritten |
| 5xx | Vorü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.
curl https://tecrube.com/api/v1/api-referansi/openapi.json \
-H "Authorization: Bearer tk_your_key" \
-o tecrube-openapi.jsonFertige 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.
pip install tecrubenpm install tecrube- Herunterladen: tecrube.py (Python 3.9+)
- Herunterladen: 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);
}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.
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
- So funktioniert esDer Weg einer Chatnachricht durch Tecrube zur Werbeplattform und sicher zurück: MCP, OAuth, Leitplanken, Freigabe von Vorschlägen, Prüfprotokoll und Rückgängig.
- Sicherheit & FreigabeDas Sicherheitsmodell von Tecrube: OAuth 2.1, Änderungen auf Ihren Wunsch und rücknehmbar, Freigabe für Vorschläge, Budget-Leitplanke, Prüfprotokoll und Ergebnisse, die der Assistent nicht erfinden kann.
- PläneDie Stufen Starter, Professional, Agentur und Enterprise: Monats- und Jahrespreise, Credit-Kontingente, Zusatzpakete, Empfehlungsprogramm und die Regeln für den Planwechsel.