Aller au contenu
Tecrübetecrube.com
Premiers pas

API et clients

Authentification par clé d'API avec le forfait Enterprise : droits, limites de débit, référence OpenAPI, clients Python et JavaScript et connexion avec les SDK MCP.

Démarrage rapide

Créez une clé dans le panneau, sous Paramètres › API, puis envoyez-la avec chaque requête dans l'en-tête Authorization.

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

Authentification et droits

  • Une clé commence par tk_ et ne s'affiche qu'une fois, à sa création ; seule son empreinte est conservée.
  • Une clé ne peut pas dépasser les droits de la personne qui l'a créée. Si celle-ci quitte l'équipe, la clé cesse de fonctionner ; si son rôle baisse, une clé d'écriture repasse en lecture.
  • Si le forfait perd l'accès à l'API, les requêtes renvoient 402. Un compte peut avoir au maximum 20 clés actives.
DroitPermetNe permet pas
readLire toutes les donnéesModifier quoi que ce soit ou lancer une tâche
writeAgit comme un administrateur de l'espace ; les changements suivent vos règles d'approbationÉquipe, mot de passe, sessions, 2FA, forfait et paiement

Limites de débit

  • API : 600 requêtes par minute par clé.
  • Outils MCP : 120 appels par minute par clé et 2 000 appels par heure par compte.
  • Au-delà, la réponse est 429 avec l'en-tête Retry-After. Les clients prêts à l'emploi relancent seuls les lectures et les 429.

Codes d'erreur

CodeSignification
401Clé absente, non valide ou révoquée
402Le forfait n'inclut pas cette action
403Le droit ou le rôle est insuffisant
404Enregistrement introuvable
422Corps ou paramètre non valide
429Limite de débit dépassée
5xxProblème temporaire du serveur ; relancez les lectures

Référence OpenAPI

Téléchargez le document OpenAPI à jour de tous les points d'accès que votre clé peut atteindre. Importez-le dans Postman ou générez des clients pour d'autres langages avec openapi-generator.

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

Clients prêts à l'emploi

Sans dépendance : installez le paquet ou ajoutez le fichier unique à votre projet et importez-le. Il comprend REST, les outils MCP, les relances et un type d'erreur.

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

Connexion avec les SDK MCP

Les SDK MCP officiels (TypeScript et Python) se connectent à cette adresse. Si vous créez votre propre assistant ou agent, envoyez la clé dans l'en-tête ; les applications agissant pour d'autres utilisateurs utilisent 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 pour applications mobiles

Tecrube n'a pas de SDK à intégrer dans votre application mobile, et vous n'en avez pas besoin. Pour la mesure dans l'application, installez directement Google Analytics for Firebase, le SDK Meta et le SDK TikTok ; Tecrube lit leurs données via vos comptes.

Étapes suivantes