Developer

API ve SDK'lar üzerine geliştir

7:50 anlatım

Videodaki anlatım İngilizcedir.

Toktik Developer API, ölçümlü bir REST API'dir ve resmî SDK'ları vardır — JavaScript/TypeScript için @toktikhq/sdk-js, Python için toktik. Hızlı başlangıç, kimlik doğrulama ve kredilerle başla, sonra hazır cURL, JavaScript ve Python örneklerini kopyala.

Neler öğreneceksin

Bir anahtar oluştur ve ilk kimliği doğrulanmış isteğini yap
Kapsamları, hız sınırlarını ve kredi modelini anla
JavaScript ve Python SDK'larını kullan
Dokümanları oku: hızlı başlangıç, uç noktalar ve kapsamlar

Nasıl çalışır

Settings içinde bir anahtar oluştur
Uygulamada Settings, sonra Developer keys'i aç ve yalnızca ihtiyacın olan kapsamlarla, örneğin sıralamalar için rank:read ile bir anahtar oluştur. Sır ttk_live_ ile başlar ve bir kez gösterilir; bu yüzden bir ortam değişkeninde sakla. Anahtarlar yalnızca veri rotalarına erişebilir ve anahtar oluşturmak oturum açmış bir işlem olarak kalır.
İlk isteğini yap
Anahtarı ttk_live_ sırrınla Authorization: Bearer olarak gönder. Dokümanlardaki hızlı başlangıç, api.toktikhq.com/v1/rankings/official adresindeki resmî sıralamayı board=hourly ve region=VN ile çağırır. 403, anahtarın o rota için kapsamı olmadığı anlamına gelir.
Sınırlar ve kredilerle çalış
Her anahtarın plana göre, Free'de 1'den Agency'de 150'ye kadar saniye başına bir istek sınırı vardır. Sınırı aşarsan 429 alırsın; Retry-After'ı bekle ve yeniden dene. Kredilerin bitmesi 402 döndürür ve yeniden denemek bunu çözmez; GET /v1/usage harcamanı gösterir.
Resmî bir SDK ekle
JavaScript ve TypeScript için npm i @toktikhq/sdk-js, Python için pip install toktik kur; ikisi de aynı v1 REST API'yi aynı anahtar ve aynı kredi cüzdanıyla çağırır. Docs sayfaları Quickstart ve API Reference her uç noktayı, parametreyi ve kapsamı listeler.

Sıkça sorulan sorular

Toktik API ne kadar tutar?

Ayrı bir API fiyat listesi yoktur. Web uygulaması ve API, aynı plandaki aynı kredi cüzdanından harcar. Toktik'in deposundan sunulan bir okuma 1 kredi, bir dışa aktarma 2,500 kredi tutar; talep üzerine toplama çağrıları daha fazlasına mal olur.

Toktik API hız sınırları nelerdir?

Anahtar başına, saniyede: Free 1, Starter 5, Pro 20, Scale 60 ve Agency 150. Günlük kotalar da geçerlidir; Free'de 5,000 istekten Agency'de 1,200,000'e kadar. Sınırı aşmak, pencere durumunu gösteren başlıklarla birlikte 429 döndürür.

Toktik'in resmî SDK'ları var mı?

Evet. @toktikhq/sdk-js JavaScript ve TypeScript'i, toktik paketi Python'u kapsar. İkisi de aynı v1 REST API'yi aynı anahtarla çağırır.

Toktik API'den gelen 402 ile 403 arasındaki fark nedir?

402, çalışma alanının kredisinin bittiği anlamına gelir; yeniden denemek yerine kredi ekle. 403, anahtarın geçerli olduğu ama gereken kapsama sahip olmadığı anlamına gelir; kapsamı ver ya da oturum açtığın bir web oturumu kullan. 429 bir hız sınırıdır ve geri çekildikten sonra yeniden denemek güvenlidir.

API dokümanlarını oku Tüm rehberler