ما هو واجهة برمجة التطبيقات (API)؟

واجهة برمجة التطبيقات (API) هي مجموعة من القواعد التي تتيح لتطبيق واحد الطلب من تطبيق آخر البيانات أو تنفيذ إجراء، ثم الحصول على إجابة واضحة. فكر في قائمة مطاعم للبرمجيات. أنت تطلب ما تريد وتسلم المطبخ.

Myth

واجهات برمجة التطبيقات ليست مخصصة للمبرمجين فقط. ليس الأمر كذلك. أنت تستدعي واجهة برمجة تطبيقات (API) في كل مرة تسحب فيها محفظتك أسعار التوكن، أو يتحقق جهازك الآلي من الغاز، أو يعرض تطبيق تبادل العملات الطلبات المفتوحة. محرك هادئ، عائد كبير.

كيف تعمل واجهة برمجة التطبيقات (API)

تخيل تطبيق محفظة يراقب السوق، ثم يشتري عند وصول التنبيه الخاص بك. خطوات سريعة أدناه.

الخطوة 1: إطلاق الشرارة أو تضغط على شراء.
الخطوة 2: يرسل التطبيق طلباً إلى نقطة نهاية مع الزوج، الجانب، والحجم.
الخطوة 3: مفتاح أو توقيع يثبت أن الدعوة مصرح بها.
الخطوة 4: يقوم الخادم بتنفيذ الإجراء، يسجله، ويعيد بيانات منظمة، غالباً JSON.
الخطوة 5: يعرض التطبيق الإتمام، يحدث رصيدك، ويدون أي أخطاء. نعم، هذا هو المسار.

لماذا تهم واجهة برمجة التطبيقات (API)

لماذا يجب أن يعن لك الأمر حتى لو لم تكتب رمزاً:

الفائدة: السرعة والوضوح. الأسعار، الأرصدة، والتداولات تصل في الوقت الفعلي.
المنظور: المحافظ، البورصات، الأوراكل، والروبوتات تتكامل مثل Lego للكبار.
الأهمية: سترى ذلك في المحافظ، dapps، DAOs، أدوات الضرائب، التنبيهات، والتحليلات.

Tip

ابدأ بمفاتيح القراءة فقط قبل إجراءات الكتابة. اجعل النطاقات محدودة، أضف قواعد IP، واختبر برصيد صغير أو بشبكة اختبار. لقمة صغيرة، ثم لقيم أكبر.

السمات الرئيسية لواجهة برمجة التطبيقات (API)

الصفات التي تجعلها عملية:

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

الت variations

الأنواع الرئيسية التي ستواجهها في عالم التشفير:

REST: طلب واستجابة واضحان عبر HTTP للأسعار والأرصدة.
GraphQL: اطلب فقط الحقول التي تريدها في استدعاء واحد.
WebSocket: تدفقات في الوقت الحقيقي للصفقات، أحداث mempool، وتTicks الأسعار.
JSONRPC: استدعاءات قياسية لعقدة لإرسال معاملة والحصول على الرصيد.
SDK: مكتبة عميل تغلف الاتصالات الشائعة لتوفير الوقت.

Reminder

اعتبر مفاتيح API كقريب من المال. خزّنها بعيداً عن مستودعات الأكواد، دوّرها بانتظام، وحافظ على نطاقاتها ضيقة. مستندات واجهة برمجة التطبيقات (API) قد تتغير، فاشترك في التحديثات قبل أن يختلط عليك أمر bot الخاص بك.

مثال

تكلف محفظتك واجهة برمجة تطبيقات (API) لجلب رصيد ETH الخاص بك، ثم أخرى لتحويل ذلك المبلغ إلى دولارات للعرض.

معلومة ممتعة

مصطلح API أقدم من التشفير بعقود من الزمن، ومع ذلك أصبحت JSON RPC اللغة الشائعة لعملاء Ethereum قبل أن تجعل المحافظ البراقة الأمر سهلاً.

نهاية

في سطر واحد، واجهة برمجة التطبيقات (API) هي القائمة التي تتيح للتطبيقات طلب البيانات أو الإجراءات بطريقة قابلة لإعادة الاستخدام من فحص الأسعار إلى المعاملات على الشبكة.

Application Programming Interface (API)