Hızlı Başlangıç

İlk Cognivo API çağrınız

Cognivo Developer API, kendi kodunuzun dApp'te ve Cognivo Sohbet'te sorabildiğiniz zincir üstü soruların aynısını sormasını sağlar. Bu sayfa en kısa yolu adım adım anlatır: bir proje oluşturun, bir anahtar oluşturun, gerçek bir çağrı çalıştırın, cevabı okuyun.

Ne zaman kullanılır

API'yi, token, cüzdan veya likidite kontrollerini her seferinde dApp'te tıklayarak yapmak yerine geliştirdiğiniz bir şeyin içinde istediğinizde kullanın; örneğin bir alım satım botu, bir dahili pano, bir uyarı görevi veya bir backend servisi. Kontrolleri yalnızca elle çalıştırmak istiyorsanız dApp ve Sohbet bunu zaten yapar ve anahtara ihtiyacınız yoktur.

Nerede bulunur

dApp'te oturum açın, kenar çubuğunda Account bölümünü açın, ardından Developers seçin. Oturum açmamış ziyaretçiler yalnızca bir tanıtım ekranı görür, bu yüzden önce oturum açın. Bu sayfadaki her şey o tek ekranda gerçekleşir.

Önce bir proje, sonra bir anahtar oluşturun

Bir proje, API anahtarlarınızı ve bunların kullanımını bir arada gruplar, bu yüzden oradan başlayın.

1. Proje seçicinin altındaki kısa formu açmak için Yeni proje'yi seçin.
2. Projelerinizi daha sonra birbirinden ayırabilmek için Proje adı alanına bir ad yazın.
3. Projeyi eklemek için Oluştur'u, formu kaydetmeden kapatmak için İptal'i seçin.
4. Proje için bir anahtar üretmek üzere Canlı anahtar oluştur'u seçin, ardından anahtarı kendi kodunuzdan gönderdiğiniz isteklerle birlikte kullanın.

Developers sayfasındaki proje denetimleri; bir anahtar oluşturmadan önce burada projenizi kurarsınız.Görseli büyüt

Proje adı yalnızca sizin için bir etikettir. İsteklerinizde görünmez ve sayfada gösterilen sınıra kadar birden fazla proje oluşturabilirsiniz.

Create live key seçtiğinizde Cognivo tam anahtarı tam olarak bir kez, kopyalama düğmesi bulunan bir iletişim kutusunda gösterir. Anahtarı o anda kopyalayın ve güvenli bir yerde saklayın. Sonrasında sayfa yalnızca maskelenmiş bir sürümü, yani öneki ve son dört karakteri gösterir; çünkü Cognivo anahtarı geri okuyamayacağı bir biçimde saklar. Bir anahtarı kaybederseniz veya sızdığını düşünürseniz anahtar satırındaki Rotate ya da Revoke seçeneğini kullanın. Eski anahtar hemen çalışmayı durdurur.

Her anahtar ayrıca neleri çağırabileceğini belirleyen Permissions taşır: Intelligence, Security ve Liquidity. Bir anahtara yalnızca ihtiyaç duyduğu izinleri verin. Aşağıdaki örnek Liquidity iznine ihtiyaç duyar.

Aynı kartta iki düğme daha yer alır. Top up credits sizi faturalandırma sayfanıza götürür. Enterprise access destek akışını açar ve özel fiyatlandırma ya da daha yüksek limitler için talep içeren tek yoldur. Normal bir canlı anahtar onay gerektirmez ve oluşturduğunuz anda çalışır.

Örnek çağrıyı çalıştırın

Quickstart sekmesini açın. Bu sekme, kendiniz bir şey yazmadan kopyalayıp çalıştırabileceğiniz çalışan bir örnek içerir.

Geliştiriciler sayfasındaki Hızlı başlangıç sekmesi, çalışan bir örnek çağrıyı buradan kopyalarsınız.Görseli büyüt

Test keys vs live keys kartı aradaki farkı anlatır. Test anahtarı, sıkı limitlerle güvenli çağrılar yapar; bu da entegrasyonu kurarken işinize yarar. Canlı anahtar ise Cognivo kredi bakiyenizden ücretlendirilen gerçek çağrılar yapar. Test a live endpoint kartı ise beş numaralı adım ile komutun kendisini, kopyalama simgesiyle birlikte verir.

Komut, gerçek bir Base kontratı üzerinde gerçek bir likidite kontrolüdür:

curl -X POST 'https://api.cognivolabs.io/v1/api/intel/liquidity' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"chain":"base","address":"0xe2b1dc2d4a3b4e59fdf0c47b71a7a86391a8b35a"}'

Aynı çağrının JavaScript veya TypeScript hali:

const res = await fetch("https://api.cognivolabs.io/v1/api/intel/liquidity", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.COGNIVO_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ chain: "base", address: "0xTOKEN_CONTRACT" }),
});
const json = await res.json();
if (json.ok) {
  console.log(json.data);
  console.log(json.meta.request_id);
} else {
  console.error(json.error);
}

Ne geri döner

Her endpoint aynı zarfla cevap verir; Quickstart sekmesindeki Expected response bloğu bunu gösterir:

{
  "ok": true,
  "data": { "identity": { "name": "...", "symbol": "..." }, "marketSnapshot": {} },
  "meta": {
    "chain": "base",
    "request_id": "capi_...",
    "credits_charged": 0,
    "generated_at": "..."
  }
}

data sonucu tutar. meta.request_id değerini kaydetmeye değer, çünkü destek ekibi tek bir çağrıyı bu değerden bulabilir. meta.credits_charged ise o çağrının tam olarak ne kadara mal olduğunu söyler.

Bir alan boş, bilinmiyor veya kullanılamıyor olarak dönebilir. Bu, orada hiçbir şey olmadığı anlamına gelmez; Cognivo'nun erişebildiği verilerden bunu doğrulayamadığı anlamına gelir. Bunu "doğrulanmadı" olarak okuyun ve sessiz bir sonucu her şey yolunda demek sanmayın. Cognivo neyi kontrol ettiğini ve ne bulduğunu bildirir; bir yanıttaki hiçbir şey bir token'ın dolandırıcılık olduğunu ya da güvenli olduğunu kanıtlamaz.

Başarısız bir çağrı, ok değeri false olan bir yanıt, bir error kodu ve bir request_id ile döner. Başarısız çağrılar ücretlendirilmez.

Maliyet, zincirler ve limitler

• Bazı endpoint'ler etkin herhangi bir anahtarla ücretsizdir. Diğerleri, başarılı çağrı başına Cognivo kredi bakiyenizden ücretlendirilir. Endpoints sekmesi her endpoint'i Cognivo kredisi cinsinden fiyatıyla, ücretsiz olanları ise Free etiketiyle listeler; bu yüzden bir endpoint üzerine geliştirme yapmadan önce oradan kontrol edin.
• Yalnızca başarılı bir çağrı için ücretlendirilirsiniz ve meta.credits_charged tutarı teyit eder. Hatalar, zaman aşımları ve engellenen çağrılar hiçbir şeye mal olmaz.
• Her hesap günde 5 ücretsiz kredi alır. Bu krediler UTC gece yarısında sıfırlanır ve ücretli kredilerden önce kullanılır.
• API bugün Ethereum, Base ve BNB Chain'i kapsar. Bazı endpoint'ler diğerlerine göre daha az zinciri destekler.
• Test anahtarlarının limitleri dardır ve bunlar ücretsiz bir üretim katmanı değildir. Keys sekmesindeki her anahtar satırı, Cognivo'nun o anahtara şu anda uyguladığı limitleri gösterir; bu limitler katman varsayılanından daha düşük olabilir.
• Askıya alınmış bir anahtar ya da askıya alınmış bir projedeki bir anahtar hiçbir şey çalıştıramaz ve portal bunun nedenini gösterir.

Anahtarınızı güvende tutun

API'yi bir sunucudan çağırın, asla tarayıcı ya da mobil uygulama kodundan çağırmayın. Anahtarı bir ortam değişkeninde veya bir gizli bilgi yöneticisinde tutun; asla herkese açık bir depoda, bir sohbet mesajında ya da ekran görüntüsünde bırakmayın. Bir anahtar sızmış olabilir diye düşünüyorsanız Keys sekmesinde döndürün (rotate) ya da iptal edin (revoke).

Sonraki adımlar

İzinler ve anahtar yönetiminin tamamı için Kimlik doğrulama ve anahtarlar, her çağrının ne döndürdüğü ve ne kadara mal olduğu için Endpoint'ler, yeniden denemeler ve hata kodları için Hız limitleri ve hatalar sayfasını okuyun. Kredi bakiyeniz ve yükleme işlemleri için Billing ve Krediler sayfasına bakın.