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.
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.
| Kapsam | Yapabildikleri | Yapamadıkları |
|---|---|---|
| read | Bütün verileri okur | Hiçbir şeyi değiştiremez, iş başlatamaz |
| write | Panel yöneticisi gibi çalışır; değişiklikler onay kurallarından geçer | Ekip, 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-Afterbaşlığı döner. Hazır istemciler okuma isteklerini ve 429'u kendisi yeniden dener.
Hata kodları
| Kod | Anlamı |
|---|---|
| 401 | Anahtar yok, geçersiz ya da iptal edilmiş |
| 402 | Plan bu işlemi içermiyor |
| 403 | Kapsam ya da rol yetmiyor |
| 404 | Kayıt bulunamadı |
| 422 | Gövde ya da parametre geçersiz |
| 429 | Hız sınırı aşıldı |
| 5xx | Sunucu 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.
curl https://tecrube.com/api/v1/api-referansi/openapi.json \
-H "Authorization: Bearer tk_your_key" \
-o tecrube-openapi.jsonHazı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.
pip install tecrubenpm install tecrube- İndir: tecrube.py (Python 3.9+)
- İndir: 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);
}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.
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
- Nasıl çalışır?Bir sohbet mesajının Tecrübe üzerinden reklam platformuna ulaşıp güvenli biçimde geri dönüşü: MCP, OAuth, korkuluklar, öneri onayı, denetim kaydı ve geri alma.
- Güvenlik & OnayTecrübe'nin güvenlik modeli: OAuth 2.1, isteğinizle uygulanan ve geri alınabilen değişiklik, önerilerin onayı, bütçe korkuluğu, denetim kaydı ve asistanın uyduramayacağı sonuçlar.
- PlanlarBaşlangıç, Profesyonel, Ajans ve Kurumsal kademeleri: aylık ve yıllık fiyatlar, kredi hakları, ek paketler, davet programı ve plan değiştirme kuralları.