JSON-RPC

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

بروتوكول JSON-RPC مستقل عن بروتوكول النقل ويمكن نقله عبر العديد من بروتوكولات نقل البيانات المختلفة، بما في ذلك إدخال /إخراج واصفات الملفات ، و HTTP ، و TCP . وهو لا يوفر أي دعم مباشر للمصادقة أو التخويل.

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

جميع أنواع التحويل عبارة عن كائنات مفردة، يتم تسلسلها باستخدام JSON. ^{[ 1 ]}

في هذه الأمثلة، -->يشير الرمز إلى البيانات المُرسلة إلى خدمة ( طلب )، بينما <--يشير الرمز إلى البيانات الواردة من خدمة. على الرغم من <--أن يُطلق عليه غالبًا اسم استجابة في الحوسبة بين العميل والخادم ، إلا أنه اعتمادًا على إصدار JSON-RPC، لا يعني بالضرورة أنه رد على طلب .

-- > { "jsonrpc" : "2.0" , "method" : "subtract" , "params" : { "minuend" : 42 , "subtrahend" : 23 }, "id" : 3 } < -- { "jsonrpc" : "2.0" , "result" : 19 , "id" : 3 }

-- > { "jsonrpc" : "2.0" , "method" : "update" , "params" : [ 1 , 2 , 3 , 4 , 5 ]}

-- > { "jsonrpc" : "2.0" , "method" : "subtract" , "params" : < -- { "jsonrpc" : "2.0" , "error" : { "code" : -32700 , "message" : "خطأ في التحليل" }, "id" : null }

-- > { "jsonrpc" : "2.0" , "method" : 1 , "params" : "bar" } < -- { "jsonrpc" : "2.0" , "error" : { "code" : -32600 , "message" : "طلب غير صالح" }, "id" : null }

-- > { "jsonrpc" : "2.0" , "method" : "foobar" , "id" : 1 } < -- { "jsonrpc" : "2.0" , "error" : { "code" : -32601 , "message" : "الطريقة غير موجودة" }, "id" : 1 }

-- > { "jsonrpc" : "2.0" , "method" : "subtract" , "params" : { "minuend" : 42 }, "id" : 2 } < -- { "jsonrpc" : "2.0" , "error" : { "code" : -32602 , "message" : "معاملات غير صالحة" , "data" : "المعامل المطلوب مفقود: subtrahend" }, "id" : 2 }

-- > { "jsonrpc" : "2.0" , "method" : "getData" , "params" : [], "id" : 4 } < -- { "jsonrpc" : "2.0" , "error" : { "code" : -32603 , "message" : "خطأ داخلي" }, "id" : 4 }

-- > [ { "jsonrpc" : "2.0" , "method" : "subtract" , "params" : [ 42 , 23 ], "id" : 1 }, { "jsonrpc" : "2.0" , "method" : "foobar" , "id" : 2 }, { "foo" : "bar" } ] < -- [ { "jsonrpc" : "2.0" , "result" : 19 , "id" : 1 }, { "jsonrpc" : "2.0" , "error" : { "code" : -32601 , "message" : "الطريقة غير موجودة" }, "id" : 2 }, { "jsonrpc" : "2.0" , "error" : { "code" : -32600 , "message" : "طلب غير صالح" }, "id" : null } ]

-- > { "version" : "1.1" , "method" : "confirmFruitPurchase" , "params" : [[ "apple" , "orange" , "mangoes" ], 1.123 ], "id" : "194521489" } < -- { "version" : "1.1" , "result" : "done" , "error" : null , "id" : "194521489" }

-- > { "method" : "echo" , "params" : [ "Hello JSON-RPC" ], "id" : 1 } < -- { "result" : "Hello JSON-RPC" , "error" : null , "id" : 1 }

• gRPC - بروتوكول RPC ثنائي متعدد المنصات
• SOAP - بروتوكول مراسلة
• JSON-WSP - بروتوكول مستوحى من JSON-RPC مع مواصفات وصف الخدمة
• بروتوكول سياق النموذج - يستخدم JSON-RPC لدمج وكلاء الذكاء الاصطناعي مع الأدوات الخارجية ^{[ 7 ]}

1. ↑ "المواصفات - JSON-RPC - Trac" . مؤرشف من الأصل بتاريخ 17-05-2008 . تم الاطلاع عليه بتاريخ 14-05-2008 .
2. ↑ "مواصفات JSON-RPC 2.0" . id: مُعرِّف يُنشئه العميل، ويجب أن يحتوي على قيمة نصية أو رقمية أو فارغة (NULL) إذا تم تضمينه. إذا لم يتم تضمينه، يُفترض أنه إشعار. لا ينبغي أن تكون القيمة فارغة (NULL) عادةً، ويجب ألا تحتوي الأرقام على أجزاء كسرية.
3. ↑ "مواصفات JSON-RPC 2.0" . الإشعار هو كائن طلب بدون عنصر "id". يشير كائن الطلب الذي هو إشعار إلى عدم اهتمام العميل بكائن الاستجابة المقابل، وبالتالي لا يلزم إرجاع أي كائن استجابة إلى العميل. يجب على الخادم عدم الرد على الإشعارات، بما في ذلك تلك الموجودة ضمن طلب مجمع. الإشعارات غير قابلة للتأكيد بحكم تعريفها، لأنها لا تحتوي على كائن استجابة ليتم إرجاعه. وبالتالي، لن يكون العميل على دراية بأي أخطاء (مثل "معاملات غير صالحة" أو "خطأ داخلي").
4. ↑ "مواصفات JSON-RPC 2.0" . النتيجة: هذا العنصر مطلوب في حالة النجاح. يجب ألا يكون هذا العنصر موجودًا في حالة حدوث خطأ أثناء استدعاء الدالة. يتم تحديد قيمة هذا العنصر بناءً على الدالة المستدعاة على الخادم.
5. ↑ "مواصفات JSON-RPC 2.0" . خطأ: هذا العنصر مطلوب في حالة الخطأ. يجب ألا يكون هذا العنصر موجودًا إذا لم يحدث أي خطأ أثناء الاستدعاء. يجب أن تكون قيمة هذا العنصر كائنًا كما هو مُعرَّف في القسم 5.1.
6. ↑ "مواصفات JSON-RPC 2.0" . كائن الخطأ: عند مواجهة استدعاء RPC لخطأ، يجب أن يحتوي كائن الاستجابة على عنصر الخطأ بقيمة كائن تتضمن العناصر التالية: (code) - رقم يشير إلى نوع الخطأ الذي حدث. يجب أن يكون هذا الرقم صحيحًا. (message) - سلسلة نصية تقدم وصفًا موجزًا ​​للخطأ. يُفضل أن تقتصر الرسالة على جملة واحدة مختصرة. (data) - قيمة أولية أو مُهيكلة تحتوي على معلومات إضافية حول الخطأ. يمكن حذف هذا العنصر. يتم تحديد قيمة هذا العنصر بواسطة الخادم (مثل معلومات الخطأ التفصيلية، والأخطاء المتداخلة، وما إلى ذلك).
7. ↑ https://modelcontextprotocol.io/docs/learn/architecture

• الموقع الرسمي
• مجموعة جوجل JSON-RPC تناقش مواضيع البروتوكول وما يتعلق به
• مواصفات JSON-RPC، وMNlinks، وما إلى ذلك.
• وصف نقل HTTP لـ JSON-RPC-2
• مواصفات OpenRPC: تنسيق وصف الخدمة لـ JSON-RPC. (واجهة برمجة تطبيقات مفتوحة، ولكن لـ JSON-RPC)
• JSend - مواصفات مماثلة تحدد فقط تنسيق الاستجابة