---
title: "وثائق نقطة نهاية BNB Smart Chain RPC"
description: "استخدم ERPC كنقطة نهاية BNB Smart Chain (BSC) RPC لطلبات HTTP JSON-RPC."
canonical: "https://erpc.global/ar/doc/bsc-rpc/general/"
locale: "ar"
---

# وثائق نقطة نهاية BNB Smart Chain RPC

## وثائق نقطة نهاية BNB Smart Chain RPC

استخدم ERPC كنقطة نهاية BNB Smart Chain RPC الخاصة بك لطلبات HTTP JSON-RPC. يُعد BNB Smart Chain 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/bsc?api-key=<YOUR_API_KEY>
```

أو إلى المضيف المخصّص:

```text
https://bsc.erpc.global?api-key=<YOUR_API_KEY>
```

تُقبل الطلبات على المسار `/` فقط.

### أمثلة

إليك مثالًا على طلب HTTP يُمرَّر فيه مفتاح API في معامل الاستعلام.

```bash
curl 'https://edge.erpc.global/bsc?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'
```

وإليك الطلب نفسه مع إرسال مفتاح API في ترويسة `Authorization`.

```bash
curl 'https://edge.erpc.global/bsc' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'
```

يمكنك الحصول على مفتاح API الخاص بك والتحقق منه في ERPC Web Dashboard: [ERPC Web Dashboard](https://dashboard.erpc.global/ar)

### الطلبات المجمّعة

يُدعم إرسال دفعات 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`. أرسل هذه الاستدعاءات واحدًا تلو الآخر بدلًا من ذلك.

### الطرق المدعومة

تخدم نقطة النهاية الطرق التالية وعددها 38، مجمّعةً حسب مساحة الاسم.

- `eth_*` (24): `eth_blockNumber`، `eth_call`، `eth_chainId`، `eth_estimateGas`، `eth_feeHistory`، `eth_gasPrice`، `eth_getBalance`، `eth_getBlockByHash`، `eth_getBlockByNumber`، `eth_getBlockReceipts`، `eth_getBlockTransactionCountByHash`، `eth_getBlockTransactionCountByNumber`، `eth_getCode`، `eth_getLogs`، `eth_getProof`، `eth_getStorageAt`، `eth_getTransactionByBlockHashAndIndex`، `eth_getTransactionByBlockNumberAndIndex`، `eth_getTransactionByHash`، `eth_getTransactionCount`، `eth_getTransactionReceipt`، `eth_maxPriorityFeePerGas`، `eth_sendRawTransaction`، `eth_syncing`
- `net_*` (3): `net_listening`، `net_peerCount`، `net_version`
- `web3_*` (2): `web3_clientVersion`، `web3_sha3`
- `txpool_*` (3): `txpool_content`، `txpool_inspect`، `txpool_status`
- `debug_*` (4): `debug_traceBlockByHash`، `debug_traceBlockByNumber`، `debug_traceCall`، `debug_traceTransaction`
- `trace_*` (2): `trace_block`، `trace_transaction`

تُقابَل أي طريقة أو مسار غير مدرج في القائمة باستجابة HTTP `400`.

### رموز حالة الاستجابة

| حالة HTTP | المعنى |
| --- | --- |
| 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 | الخدمة غير متاحة مؤقتًا. |

### طرق BNB Smart Chain RPC والوثائق

للقائمة الكاملة بالطرق القياسية والمعاملات والمواصفات، يُرجى الرجوع إلى الوثائق الرسمية.

[https://docs.bnbchain.org/bnb-smart-chain/developers/json_rpc/json-rpc-endpoint/](https://docs.bnbchain.org/bnb-smart-chain/developers/json_rpc/json-rpc-endpoint/)
