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.
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.
| Droit | Permet | Ne permet pas |
|---|---|---|
| read | Lire toutes les données | Modifier quoi que ce soit ou lancer une tâche |
| write | Agit 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
| Code | Signification |
|---|---|
| 401 | Clé absente, non valide ou révoquée |
| 402 | Le forfait n'inclut pas cette action |
| 403 | Le droit ou le rôle est insuffisant |
| 404 | Enregistrement introuvable |
| 422 | Corps ou paramètre non valide |
| 429 | Limite de débit dépassée |
| 5xx | Problè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.
curl https://tecrube.com/api/v1/api-referansi/openapi.json \
-H "Authorization: Bearer tk_your_key" \
-o tecrube-openapi.jsonClients 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.
pip install tecrubenpm install tecrube- Télécharger: tecrube.py (Python 3.9+)
- Télécharger: 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);
}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.
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
- Comment ça marcheLe parcours d'un message de chat à travers Tecrube jusqu'à la plateforme publicitaire et retour en toute sécurité : MCP, OAuth, garde-fous, validation des suggestions, journal d'audit et annulation.
- Sécurité & validationLe modèle de sécurité de Tecrube : OAuth 2.1, changements appliqués à votre demande et annulables, validation des suggestions, garde-fou budgétaire, journal d'audit et résultats que l'assistant ne peut pas inventer.
- OffresLes niveaux Démarrage, Professionnel, Agence et Entreprise : prix mensuels et annuels, crédits inclus, packs complémentaires, programme de parrainage et règles de changement d'offre.