إنتقل إلى المحتوى الرئيسي

نظرة عامة على Developer API

ما هو Developer API​

يتيح لك Cognivo Developer API استدعاء الذكاء نفسه على السلسلة الذي يشغّل Cognivo Chat والتطبيق اللامركزي وبوت Telegram من داخل شيفرتك الخاصة. تنشئ مشروعاً، وتنشئ مفتاح API، وترسل الطلبات عبر HTTPS العادي.

  1. منطقة المطورين هي المكان الذي تنشئ فيه المشاريع وتدير فيه مفاتيح Cognivo API الخاصة بك.
  2. اختر تسجيل الدخول لفتح بوابة المطورين. تبقى مفاتيحك خاصة بحسابك.
صفحة المطورين في تطبيق Cognivo اللامركزي.تكبير الصورة

متى تستخدمه​

استخدمه عندما تريد إجابات Cognivo داخل شيء تبنيه بدلاً من داخل Cognivo. الحالات الشائعة:

  • بوت مجتمعي يلصق فيه أحدهم عنوان عقد فيحصل على إشارات مخاطر، وسياق السيولة والأقفال، وقراءة لسبب هبوط توكن.
  • لوحة مراقبة لخزينة أو فريق أو محفظة حوت: مدى التعرّض للموافقات، والتحركات الأخيرة، والأرباح والخسائر المحققة لكل توكن.
  • دفتر بحث يسحب بيانات التوكنات والمحافظ إلى Python أو JavaScript لدراسة أو مراجعة لاحقة.

وهو ليس وصولاً خاماً إلى عقدة أو RPC. أنت تستدعي دائماً نقاط نهاية Cognivo المنسّقة. ولا يوجد تداول أو تنفيذ أوامر أو أدوات MEV. النتائج إشارات ذكاء لا نصيحة مالية، والنتيجة النظيفة لا تعني أبداً أن التوكن آمن.

أين تجده​

في التطبيق اللامركزي، افتح الشريط الجانبي، ثم الحساب، ثم Developers. الرابط المباشر هو dapp.cognivolabs.io/en/developers. يجب أن تكون مسجّل الدخول بحساب Cognivo المعتاد لديك. وعند تسجيل الخروج، تعرض الصفحة شاشة تعريفية فقط، بلا مشاريع أو مفاتيح.

أعلى صفحة Developers في التطبيق اللامركزي، حيث تجد عنوان URL الأساسي وكيفية إرسال مفتاح API الخاص بك.تكبير الصورة

تحمل البطاقة في أعلى الصفحة الأشياء الثلاثة التي تحتاج إليها لإجراء أول استدعاء:

  • عنوان URL الأساسي: https://api.cognivolabs.io. أضف إليه مسار نقطة نهاية لإجراء طلب.
  • المصادقة: أرسل مفتاح API الخاص بك في ترويسة X-API-Key مع كل طلب. احتفظ بالمفتاح على خادمك، ولا تضعه أبداً في شيفرة المتصفح.
  • السلاسل: تعرض الصفحة أن Ethereum وBase وBSC حية، وأن المزيد من السلاسل قريباً. وبعض نقاط النهاية تدعم سلاسل أقل من غيرها، ومرجع نقاط النهاية يوضّح أيها.

وتربط البطاقة نفسها بهذه المستندات وبـ مواصفة OpenAPI القابلة للقراءة آلياً، والتي يمكنك استيرادها إلى Postman أو Insomnia أو مولّد SDK.

للصفحة نفسها أربع علامات تبويب: البداية السريعة والمفاتيح ونقاط النهاية وUsage. ونقاط النهاية مرجع بأمثلة قابلة للنسخ وسعر كل استدعاء. ولا يوجد مشغّل حي في الصفحة، لذا فإن ما تقرؤه هناك لا ينفق شيئاً.

الوصول والمفاتيح والتكلفة​

المفاتيح الحية خدمة ذاتية. أنشئ واحداً فيعمل فوراً، دون طلب ودون طابور موافقات. وتذكر البوابة النموذج بوضوح: بعض نقاط النهاية مجانية بأي مفتاح نشط، وأخرى تحتاج إلى وصول مدفوع أو Enterprise وتُحصَّل عن كل استدعاء ناجح من رصيد أرصدة Cognivo لديك.

  • المفاتيح الحية (cogv_live_) تجري استدعاءات حقيقية. ويُحصَّل كل استدعاء ناجح بأرصدة Cognivo بالسعر المنشور لتلك نقطة النهاية. أما الاستدعاءات الفاشلة فلا يُحصَّل عليها شيء أبداً. تحصيل الرسوم على استدعاءات Developer API متوقف اليوم، لذا لا يخصم الاستدعاء الناجح أي رصيد ولا يتغير رصيدك.
  • المفاتيح التجريبية (cogv_test_) موسومة بـ Test في البوابة. ولها حدود ضيقة وهي لتجربة الـ API، لا لحركة حقيقية.
  • يعرض كل مفتاح وضع الوصول الخاص به في علامة تبويب المفاتيح، مثل مدفوع أو تجريبي أو شريك أو Sandbox أو Enterprise أو طلب وصول. والمفتاح في حالة طلب وصول يجب أن يُعتمد قبل أن يشغّل نقاط النهاية المدفوعة، والمفتاح المعلّق لا يستطيع استدعاء أي شيء. وتعرض البوابة السبب.
  • Enterprise هو المسار الوحيد الذي تطلب فيه وصولاً، للحصول على تسعير وحدود مخصّصة. وزر وصول Enterprise يفتح مسار الدعم.

تأتي الأرصدة من الرصيد نفسه الذي تستخدمه في كل مكان آخر في Cognivo، ويحصل كل حساب على 5 أرصدة مجانية يومياً تُعاد عند منتصف الليل بتوقيت UTC. وإذا كان رصيدك لا يغطي استدعاءً تحصل على خطأ 402 بالكود payment_required، ولا يُحصَّل شيء. اشحن رصيدك وحاول مرة أخرى. راجع Billing والأرصدة لمعرفة كيف يعمل الرصيد.

نقطة النهاية GET /v1/api/health مجانية ولا تحتاج إلى مفتاح. وGET /v1/api/me مجانية بأي مفتاح صالح. وGET /v1/api/discover مجانية بحدّ يومي ضيق. وأسعار كل نقطة نهاية موجودة في مرجع نقاط النهاية وحدود المعدل والأخطاء والفوترة.

ماذا يعود إليك، وماذا تعني الإجابة الفارغة​

تحمل الاستجابات ذكاءً عاماً على السلسلة فقط. وهي لا تتضمن أبداً معرّفات حسابات Cognivo أو رسائل بريد إلكتروني أو أرصدة أو أي بيانات حساب خاصة أخرى، سواء كانت لك أو لأي شخص آخر. والاستثناء الوحيد هو GET /v1/api/me، التي تُبلغ عن رصيد أرصدة المفتاح المستدعي نفسه حتى تتمكن من متابعة إنفاقك.

الحقل الفارغ أو القيمة غير المعروفة يعني أن Cognivo لم يستطع التحقق من ذلك العنصر لهذا التوكن أو المحفظة على هذه السلسلة. ولا يعني ذلك أن العنصر غير موجود، ولا يعني أن الموضوع نظيف. تعامل مع النتيجة المفقودة على أنها غير مُتحقَّق منها، واستخدم معرّف الطلب في الاستجابة إذا احتجت إلى متابعتها.

الخطوات التالية​

  1. سجّل الدخول وأنشئ مشروعاً، ثم أنشئ مفتاحاً حياً. يُعرض المفتاح الكامل مرة واحدة، لذا انسخه فوراً.
  2. نفّذ أول استدعاء لك مع البداية السريعة.
  3. اقرأ المصادقة ومفاتيح API للاطلاع على الصلاحيات والتدوير وأمان المفاتيح.