İçeriğe geç
Tecrübetecrube.com
İlk adımlar

API ve istemciler

Enterprise planında API anahtarıyla kimlik doğrulama, kapsamlar, hız sınırı, OpenAPI referansı, Python ve JavaScript istemcileri, MCP SDK bağlantısı.

Hızlı başlangıç

Panelde Ayarlar › API ekranından bir anahtar oluşturun ve her isteğe Authorization başlığı olarak ekleyin.

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

Kimlik doğrulama ve kapsam

  • Anahtar tk_ ile başlar ve yalnız oluşturulurken bir kez gösterilir; sistemde yalnız özeti saklanır.
  • Anahtar, oluşturan kişinin yetkisini aşamaz. Kişi ekipten çıkarsa anahtar çalışmaz; rolü düşerse yazma anahtarı okumaya iner.
  • Plan API erişimini kaybederse istekler 402 döner. Bir hesapta en fazla 20 etkin anahtar olabilir.
KapsamYapabildikleriYapamadıkları
readBütün verileri okurHiçbir şeyi değiştiremez, iş başlatamaz
writePanel yöneticisi gibi çalışır; değişiklikler onay kurallarından geçerEkip, parola, oturum, 2FA, plan ve ödeme işlemleri

Hız sınırı

  • API: anahtar başına dakikada 600 istek.
  • MCP araçları: anahtar başına dakikada 120 çağrı, hesap başına saatte 2.000 çağrı.
  • Sınır aşılınca 429 ve Retry-After başlığı döner. Hazır istemciler okuma isteklerini ve 429'u kendisi yeniden dener.

Hata kodları

KodAnlamı
401Anahtar yok, geçersiz ya da iptal edilmiş
402Plan bu işlemi içermiyor
403Kapsam ya da rol yetmiyor
404Kayıt bulunamadı
422Gövde ya da parametre geçersiz
429Hız sınırı aşıldı
5xxSunucu tarafında geçici sorun; okuma isteklerini yeniden deneyin

OpenAPI referansı

Anahtarınızın erişebildiği bütün uçların güncel OpenAPI belgesini indirin. Postman'e aktarabilir ya da openapi-generator ile başka dillerde istemci üretebilirsiniz.

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

Hazır istemciler

Bağımlılık yok: paket olarak kurun ya da tek dosyayı projenize koyup içe aktarın. REST, MCP araçları, yeniden deneme ve hata türü içerir.

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

MCP SDK ile bağlanmak

Resmî MCP SDK'ları (TypeScript ve Python) bu adrese bağlanır. Kendi asistanınızı ya da ajanınızı yazıyorsanız anahtarı başlıkta gönderin; kullanıcı adına çalışan uygulamalar OAuth 2.1 kullanır.

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

Mobil uygulama SDK'sı

Tecrube'nin mobil uygulamanıza gömülen bir SDK'sı yoktur ve gerekmez. Uygulama içi ölçüm için Google Analytics for Firebase, Meta SDK ve TikTok SDK'yı doğrudan kurarsınız; Tecrube bu platformların verisini hesaplarınız üzerinden okur.

Sıradaki adımlar