وثائق نقطة نهاية NEAR RPC | ERPC
وثائق نقطة نهاية NEAR RPC
استخدم ERPC كنقطة نهاية NEAR RPC الخاصة بك لطلبات HTTP JSON-RPC. يُعد NEAR RPC جزءًا من RPC APIs الخاصة بـERPC ضمن Global Edge Blockchain Infrastructure لدينا، ويمكن إدارة مفتاح API من ERPC Web Dashboard.
يمكنك استخدام نفس مفتاح RPC الذي تستخدمه مع Solana وEthereum وAvalanche.
مرِّر مفتاح API الخاص بك في معامل الاستعلام
api-key، أو أرسله بصيغة Authorization: Bearer <YOUR_API_KEY>. وعند وجود الاثنين معًا، يُستخدم معامل الاستعلام.نقاط النهاية
أرسل طلبات JSON-RPC 2.0 كطلبات HTTP POST إلى:
text
https://edge.erpc.global/near?api-key=<YOUR_API_KEY>https://edge.erpc.global/near?api-key=<YOUR_API_KEY>أو إلى المضيف المخصّص:
text
https://near.erpc.global?api-key=<YOUR_API_KEY>https://near.erpc.global?api-key=<YOUR_API_KEY>تُقبل الطلبات على المسار
/ فقط.أمثلة
إليك مثالًا على طلب HTTP يُمرَّر فيه مفتاح API في معامل الاستعلام.
bash
curl 'https://edge.erpc.global/near?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"block",
"params":{"finality":"final"}
}'curl 'https://edge.erpc.global/near?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"block",
"params":{"finality":"final"}
}'وإليك الطلب نفسه مع إرسال مفتاح API في ترويسة
Authorization.bash
curl 'https://edge.erpc.global/near' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
"jsonrpc":"2.0","id":1,
"method":"block",
"params":{"finality":"final"}
}'curl 'https://edge.erpc.global/near' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
"jsonrpc":"2.0","id":1,
"method":"block",
"params":{"finality":"final"}
}'يمكنك الحصول على مفتاح API الخاص بك والتحقق منه في ERPC Web Dashboard: ERPC Web Dashboard
الطلبات المجمّعة
يُدعم إرسال دفعات JSON-RPC تضم ما بين 1 و100 استدعاء لكل طلب HTTP. يجب أن يكون لكل استدعاء
id خاص به، ولا يجوز تكرار قيم id داخل الدفعة الواحدة. يُحتسب كل استدعاء ضمن الطلب المجمّع كاستدعاء مستقل. يمكن أن يصل حجم جسم الطلب إلى 1 MiB.قياس الاستخدام
يُقاس الاستخدام بالرموز، وقد يختلف معدل الرموز باختلاف الطريقة. يُقاس كل استدعاء في الطلب المجمّع عبر HTTP بشكل منفصل.
حدود خطة Free
في خطة Free، يمكن لحسابك إرسال طلب واحد كل 10 ثوانٍ. يُحتسب هذا الحد لكل حساب وليس لكل نقطة نهاية، لذا قد يُحتسب ضمنه أيضًا طلب موجَّه إلى سلسلة أخرى. يُقابَل الطلب المُرسَل قبل ذلك باستجابة HTTP
429، وتحدد ترويسة retry-after مدة الانتظار بالثواني.في خطة Free، يُقابَل أي طلب يحتوي على استدعاءين أو أكثر من استدعاءات JSON-RPC باستجابة HTTP
429، ولا يُرسَل أي من استدعاءاته: يتلقى كل استدعاء خطأ JSON-RPC بالرمز -32041. أرسل هذه الاستدعاءات واحدًا تلو الآخر بدلًا من ذلك.الطرق المدعومة
تخدم نقطة النهاية طرق NEAR JSON-RPC التالية. وتُرسَل طرق
EXPERIMENTAL_ مع البادئة بالأحرف الكبيرة.- الطرق (17):
EXPERIMENTAL_changes_in_block،EXPERIMENTAL_genesis_config،EXPERIMENTAL_protocol_config،EXPERIMENTAL_receipt،EXPERIMENTAL_receipt_to_tx،EXPERIMENTAL_tx_status،EXPERIMENTAL_validators_ordered،block،broadcast_tx_async،broadcast_tx_commit،chunk،gas_price،network_info،send_tx،status،tx،validators query(6 قيم لـrequest_type):call_function،view_access_key،view_access_key_list،view_account،view_code،view_stateEXPERIMENTAL_changes(5 قيم لـchanges_type):account_changes،all_access_key_changes،contract_code_changes،data_changes،single_access_key_changes
يجب إرسال
query وEXPERIMENTAL_changes مع params على هيئة كائن يحمل قيمة request_type أو changes_type المذكورة أعلاه.تُقابَل أي طريقة غير مدرجة في القائمة باستجابة HTTP
400.رموز حالة الاستجابة
| HTTP status | المعنى |
|---|---|
| 200 | استجابة JSON-RPC من upstream. ويُعاد خطأ JSON-RPC أيضًا مع HTTP 200: يحتفظ بقيمتي id الطلب وerror.code، وتكون قيمة error.message هي ERPC upstream error، ولا يُعاد error.data. |
| 400 | طريقة أو مسار خارج قائمة الطرق المدعومة، أو طلب JSON-RPC غير صالح، أو دفعة فارغة أو دفعة تتجاوز 100 استدعاء، أو id مكرر داخل دفعة، أو جسم طلب يتجاوز 1 MiB. |
| 401 | مفتاح API مفقود أو غير صالح، أو عدم استيفاء قيد IP أو Origin المفروض على المفتاح. |
| 405 | طريقة طلب HTTP غير POST. |
| 426 | طُلب WebSocket Upgrade. تعمل نقطة النهاية عبر HTTP فقط. |
| 429 | تقييد المعدل، بما في ذلك حدود خطة Free الواردة أعلاه: أكثر من طلب واحد كل 10 ثوانٍ، أو استدعاءان أو أكثر في طلب واحد. إذا وُجدت ترويسة retry-after، فانتظر عدد الثواني المحدد فيها. |
| 502 | تعذّر إكمال طلب upstream: فشل استجابة upstream، أو استجابة تتجاوز 8 MiB، أو عدم ورود رد خلال 30 ثانية. |
| 503 | الخدمة غير متاحة مؤقتًا. |
طرق NEAR RPC والوثائق
للقائمة الكاملة بالطرق القياسية والمعاملات والمواصفات، يُرجى الرجوع إلى الوثائق الرسمية.