Cognivo Developer API
تتيح لك Cognivo Developer API استدعاء نفس الذكاء على السلسلة الذي يشغّل Cognivo Chat والتطبيق اللامركزي (dApp) وبوت Telegram من تطبيقك أو بوتك أو لوحة بياناتك أو خادمك الخلفي.
- عنوان الأساس (Base URL):
https://api.cognivolabs.io - المصادقة: مفاتيح API ذات نطاقات صلاحية تنشئها بنفسك في بوابة المطورين
- السلاسل المتاحة اليوم: Ethereum (
eth) و Base (base) و BNB Smart Chain (bsc) - Solana: قريباً (غير متاحة بعد)
- Webhooks: مخطط لها (غير متاحة بعد)
- مواصفة OpenAPI: cognivo-public-api.yaml - المواصفة الكاملة القابلة للقراءة آلياً؛ استوردها إلى Postman أو Insomnia أو مولّد SDK
ماذا يمكنني أن أبني؟
أي شيء يحتاج قراءة سريعة وصادقة عن توكن أو محفظة. بعض الأفكار الملموسة:
- بوتات فحص أمان التوكنات - بوت يلصق فيه المستخدمون عنوان عقد فيحصلون على إشارات المخاطر وسياق السيولة والأقفال وإجابة "لماذا ينخفض السعر" في رسالة واحدة
- لوحات مراقبة المحافظ - راقب محفظة خزينة أو حوت أو فريق: تعرّض الموافقات (approvals)، والتحركات الأخيرة الدقيقة، والأرباح والخسائر المحققة (PnL) لكل توكن
- أدوات مجتمعية لـ Telegram أو Discord - امنح مجتمعك أمر
/check <token>مدعوماً بنفس الذكاء الذي يشغّل Cognivo Chat - عروض PnL للمحافظ الاستثمارية - أظهر للمستخدمين أرباحهم وخسائرهم المحققة لكل توكن، محسوبة من نشاط موثّق على السلسلة بدلاً من أرقام مُبلّغ عنها ذاتياً
- دفاتر بحث - اسحب بيانات المخاطر والسيولة ومحافظ الفريق والتحركات إلى دفاتر Python أو JavaScript لدراسات التوكنات وتحليلات ما بعد الحدث
- خلاصات الاستكشاف - اعرض بطاقات الذكاء العامة عالية الجودة الأخيرة من خلاصة Discover في تطبيقك أو موقعك
ما الذي ليست عليه هذه الـ API
- إنها ليست وصولاً خاماً إلى عقدة/RPC. أنت تستدعي دائماً نقاط نهاية ذكاء Cognivo المنسّقة؛ ولا يتم أبداً كشف RPC السلسلة الخام أو إعادة بيعه.
- إنها لا تشمل التداول أو تنفيذ الأوامر أو أدوات MEV.
- النتائج هي إشارات ذكاء، وليست نصيحة مالية وليست ضماناً. النتيجة النظيفة لا تعني أبداً "آمن".
نموذج الوصول والتسعير
المفاتيح الحية خدمة ذاتية وبنظام الدفع حسب الاستخدام. أنشئ مفتاحاً فيعمل فوراً: لا طلب تقديم، ولا طابور موافقات، ولا مكالمة مبيعات. كل استدعاء ناجح يُحصَّل بأرصدة Cognivo من رصيد أرصدة حسابك وفق الأسعار المنشورة لكل نقطة نهاية؛ والاستدعاءات الفاشلة لا يُحصَّل عليها شيء أبداً.
- المفاتيح الحية (
cogv_live_) هي الطريقة القياسية لاستخدام الـ API. تُفوتر بالدفع حسب الاستخدام من نفس رصيد أرصدة Cognivo الذي تستخدمه في الأماكن الأخرى. إذا لم يستطع رصيدك تغطية استدعاء، فستحصل على خطأ402بالكودpayment_requiredولا يُحصَّل شيء: اشحن رصيدك في صفحة الفوترة لحساب Cognivo الخاص بك وحاول مجدداً. - مفاتيح Sandbox (
cogv_test_) موسومة بوضوح بأنها Sandbox، وهي مخصصة للعروض التوضيحية المحدودة واختبار التكامل فقط. لا يمكنها تشغيل الذكاء الحي. - التجريبي (Trial) مخصص تقييم اختياري يمنحه مسؤول. لا تحتاجه أبداً للاستخدام المدفوع العادي.
- الشراكة (Partner) ترتيب يديره المسؤولون.
- المؤسسي (Enterprise) هو المسار الوحيد الذي تطلب فيه الوصول: تسعير مخصص وحدود مخصصة وأحجام كبيرة. اطلبه من بوابة المطورين.
- المفتاح المعلّق لا يمكنه تنفيذ أي شيء؛ وتعرض البوابة السبب.
تُنشر أسعار الأرصدة لكل نقطة نهاية على صفحتي مرجع نقاط النهاية وحدود المعدل والأخطاء والفوترة. GET /v1/api/health مجانية ولا تحتاج إلى مفتاح، وGET /v1/api/me مجانية بأي مفتاح صالح، وGET /v1/api/discover مجانية مع حد معدل مشدود.
الخصوصية وسلامة البيانات
تعيد الـ API ذكاءً عاماً على السلسلة فقط. لا تتضمن الاستجابات أبداً معرّفات حسابات Cognivo أو رسائل البريد الإلكتروني أو الأرصدة أو أي بيانات حساب خاصة أخرى - سواء كانت لك أو لأي شخص آخر. الاستثناء الوحيد هو GET /v1/api/me، التي تعرض للمفتاح المستدعي رصيد أرصدة حسابه هو حتى تتمكن من مراقبة إنفاقك.
البدء
- سجّل الدخول في dapp.cognivolabs.io/en/developers بحساب Cognivo العادي الخاص بك.
- أنشئ مشروعاً ومفتاح API حياً (يُعرض المفتاح الكامل مرة واحدة بالضبط - انسخه فوراً). يعمل على الفور.
- اتبع البداية السريعة - أول استدعاء لك في 30 ثانية.