Developer API Genel Bakış

Developer API nedir

Cognivo Developer API, Cognivo Chat'i, dApp'i ve Telegram botunu çalıştıran zincir üstü istihbaratın aynısını kendi kodunuzdan çağırmanızı sağlar. Bir proje oluşturur, bir API anahtarı oluşturur ve istekleri düz HTTPS üzerinden gönderirsiniz.

1. Geliştiriciler alanı, projeler oluşturduğunuz ve Cognivo API anahtarlarınızı yönettiğiniz yerdir.
2. Geliştirici portalını açmak için Oturum aç'ı seçin. Anahtarlarınız hesabınıza özel kalır.

Cognivo dApp'indeki Geliştiriciler sayfası.Görseli büyüt

Ne zaman kullanılır

Cognivo yanıtlarını Cognivo'nun içinde değil, kendi geliştirdiğiniz bir şeyin içinde istediğinizde kullanın. Yaygın örnekler:

• Birinin bir kontrat adresi yapıştırdığı ve karşılığında risk sinyalleri, likidite ve kilit bağlamı ile bir token'ın neden düştüğüne dair bir okuma aldığı bir topluluk botu.
• Bir hazine, ekip veya balina cüzdanı için izleme paneli: onay (approval) maruziyeti, son hareketler, token başına gerçekleşmiş kar ve zarar.
• Bir çalışma veya olay sonrası inceleme için token ve cüzdan verilerini Python'a ya da JavaScript'e çeken bir araştırma not defteri.

Bu, ham düğüm veya RPC erişimi değildir. Her zaman özenle seçilmiş Cognivo endpoint'lerini çağırırsınız. Alım satım, emir yürütme veya MEV araçları yoktur. Sonuçlar istihbarat sinyalleridir, finansal tavsiye değildir ve temiz bir sonuç asla bir token'ın güvenli olduğu anlamına gelmez.

Nerede bulunur

dApp'te kenar çubuğunu açın, ardından Hesap, ardından Developers. Doğrudan bağlantı: dapp.cognivolabs.io/en/developers. Normal Cognivo hesabınızla oturum açmış olmanız gerekir. Oturumunuz kapalıyken sayfa yalnızca bir tanıtım ekranı gösterir, proje veya anahtar göstermez.

dApp'teki Developers sayfasının üst kısmı; temel URL'yi ve API anahtarınızı nasıl göndereceğinizi burada bulursunuz.Görseli büyüt

Sayfanın üstündeki kart, ilk çağrınızı yapmak için ihtiyaç duyduğunuz üç şeyi taşır:

• Base URL: https://api.cognivolabs.io. İstek yapmak için buna bir endpoint yolu ekleyin.
• Kimlik doğrulama: API anahtarınızı her istekte X-API-Key başlığında gönderin. Anahtarı sunucunuzda tutun, asla tarayıcı kodunda tutmayın.
• Zincirler: sayfa Ethereum, Base ve BSC canlı ile Daha fazla zincir çok yakında bilgisini gösterir. Bazı endpoint'ler diğerlerinden daha az zinciri destekler ve hangisinin hangi zinciri desteklediğini Endpoint referansı söyler.

Aynı kart bu dokümantasyona ve makine tarafından okunabilir OpenAPI spesifikasyonuna bağlantı verir; bu spesifikasyonu Postman'e, Insomnia'ya veya bir SDK üretecine aktarabilirsiniz.

Sayfanın kendisinde dört sekme vardır: Quickstart, Keys, Endpoints ve Usage. Endpoints, kopyalanabilir örnekler ve her çağrının fiyatıyla birlikte bir referanstır. Sayfada canlı bir çalıştırıcı yoktur, bu yüzden orada okuduğunuz hiçbir şey harcamaya yol açmaz.

Erişim, anahtarlar ve maliyet

Canlı anahtarlar kendi kendine hizmet esasına dayanır. Bir tane oluşturursunuz ve başvuru ya da onay kuyruğu olmadan hemen çalışır. Portal modeli açıkça belirtir: bazı endpoint'ler herhangi bir aktif anahtarla ücretsizdir, diğerleri ücretli veya Enterprise erişim gerektirir ve başarılı çağrı başına Cognivo kredi bakiyenizden ücretlendirilir.

• Canlı anahtarlar (cogv_live_) gerçek çağrılar yapar. Başarılı her çağrı, o endpoint için yayımlanan fiyattan Cognivo kredisi olarak ücretlendirilir. Başarısız çağrılar asla ücretlendirilmez. Developer API çağrıları için ücretlendirme bugün kapalıdır, bu yüzden başarılı bir çağrı hiçbir şey düşmez ve bakiyeniz değişmez.
• Test anahtarları (cogv_test_) portalda Test olarak etiketlenir. Sıkı sınırları vardır ve gerçek trafik için değil, API'yi denemek içindir.
• Her anahtar, Keys sekmesinde erişim modunu gösterir; örneğin Paid, Trial, Partner, Sandbox, Enterprise veya Request access. Request access durumundaki bir anahtarın ücretli endpoint'leri çalıştırabilmesi için önce onaylanması gerekir ve Suspended durumdaki bir anahtar hiçbir şeyi çağıramaz. Portal nedenini gösterir.
• Enterprise, erişim talep ettiğiniz tek yoldur ve özel fiyatlandırma ile limitler içindir. Enterprise erişim düğmesi destek akışını açar.

Krediler, Cognivo'da her yerde kullandığınız bakiyenin aynısından gelir ve her hesap, UTC gece yarısında sıfırlanan günde 5 ücretsiz kredi alır. Bakiyeniz bir çağrıyı karşılayamıyorsa payment_required koduyla bir 402 hatası alırsınız ve hiçbir ücret alınmaz. Bakiyenizi yükleyip tekrar deneyin. Bakiyenin nasıl çalıştığı için Faturalama ve krediler sayfasına bakın.

GET /v1/api/health ücretsizdir ve anahtar gerektirmez. GET /v1/api/me geçerli herhangi bir anahtarla ücretsizdir. GET /v1/api/discover sıkı bir günlük üst sınırla ücretsizdir. Endpoint başına fiyatlar Endpoint referansı ile Hız limitleri, hatalar ve faturalama sayfalarındadır.

Karşılığında ne gelir ve boş bir yanıt ne anlama gelir

Yanıtlar yalnızca herkese açık zincir üstü istihbarat taşır. Ne sizin ne de başkasının Cognivo hesap tanımlayıcılarını, e-postalarını, bakiyelerini ya da diğer özel hesap verilerini asla içermez. Tek istisna, çağrıyı yapan anahtarın kendi kredi bakiyesini bildiren GET /v1/api/me'dir, böylece harcamanızı izleyebilirsiniz.

Boş bir alan veya bilinmeyen bir değer, Cognivo'nun bu zincirdeki bu token ya da cüzdan için o öğeyi doğrulayamadığı anlamına gelir. Öğenin bulunmadığı anlamına gelmez ve konunun temiz olduğu anlamına gelmez. Eksik bir sonucu doğrulanmamış olarak değerlendirin ve takibini yapmanız gerekirse yanıttaki istek kimliğini (request ID) kullanın.

Sonraki adımlar

1. Oturum açıp bir proje oluşturun, ardından bir canlı anahtar oluşturun. Tam anahtar bir kez gösterilir, bu yüzden hemen kopyalayın.
2. İlk çağrınızı Hızlı Başlangıç ile yapın.
3. İzinler, anahtar döndürme ve anahtar güvenliği için Kimlik doğrulama ve API anahtarları sayfasını okuyun.