DotNetCore.SKIT.FlurlHttpClient.Wechat
1.0.0
تتضمن WeChat HTTP API SDK المستندة إلى Flurl.Http حاليًا منصة عامة ومنصة مفتوحة ومنصة تجارية وWeChat للشركات ومنصة إعلانية ومنصة حوار مفتوحة ووحدات أخرى.
لمزيد من مجموعات تطوير سلسلة SKIT.FlurlHttpClient، الرجاء النقر هنا.
Flurl.Http .System.Text.Json (افتراضي) و Newtonsoft.Json .| اسم | نوجيت | آخر |
|---|---|---|
| المنصة العامة (الحساب الرسمي، البرنامج المصغر، حساب الفيديو) + فتح وحدة النظام الأساسي | توثيق التطوير | نموذج للمشروع | |
| وحدة منصة التاجر (دفع WeChat) (لواجهة الإصدار v3) | توثيق التطوير | نموذج للمشروع | |
| وحدة منصة التاجر (دفع WeChat) (لواجهة الإصدار v2) | وثائق التطوير | |
| وحدة WeChat للمؤسسات (حساب المؤسسة). | وثائق التطوير | |
| وحدة منصة الإعلان (Guangdiantong). | وثائق التطوير | |
| وحدة منصة الحوار المفتوحة (الحوار الذكي WeChat). | وثائق التطوير | |
| وحدة الدفع للمؤسسات الصغيرة في Tencent | وثائق التطوير |
Flurl.Http ؟ Flurl.Http هي مكتبة HTTP خفيفة الوزن وواحدة من مكتبات الامتدادات الأكثر شيوعًا في .NET. تتجاوز تنزيلاتها التراكمية على NuGet 17 مليونًا، ويتجاوز متوسط التنزيلات اليومية 6000، وGitHub 2.6k Stars (إحصاءات البيانات اعتبارًا من 2021-06-). 01).
ملحوظة: Shengpai WeChat SDK هو مشروع .NET مفتوح المصدر محلي معروف بدأه السيد Su Zhenwei.
تركز هذه المكتبة على تغليف واجهة برمجة التطبيقات نفسها، وتوفر أيضًا بعض فئات الأدوات للتشفير وفك التشفير والتسلسل، وهي أكثر مرونة في الاستخدام ولا تقتصر على أي إطار عمل أو نوع مشروع؛ وتوفر Shengpai WeChat SDK وظائف كبيرة وشاملة ، وهو متوافق مع التكامل العميق لـ MVC / WebAPI.
يتبع نموذج الواجهة لهذه المكتبة طريقة تسمية سمات C# (تسمية Pascal) الموصى بها رسميًا من قبل Microsoft؛ يوفر Shengpai WeChat SDK طريقة تسمية واجهة WeChat نفسها (مزيج من التسميات على شكل ثعبان وتسميات حالة الجمل).
تحتوي هذه المكتبة تقريبًا على جميع واجهات برمجة التطبيقات المقدمة رسميًا حاليًا بواسطة WeChat (تم إدراج الأسباب المحددة لعدد قليل جدًا من واجهات برمجة التطبيقات غير المدعومة في وثائق كل وحدة)؛ توفر Shengpai WeChat SDK واجهات برمجة التطبيقات شائعة الاستخدام فقط.
فيما يتعلق بهذه النقطة، علينا أن نشكو من واجهة برمجة التطبيقات التي يوفرها WeChat. من الواضح أن العديد من الفرق تعمل على تطويرها بشكل مشترك داخل WeChat، كل فريق، أو حتى كل شخص، لديه أنماط مختلفة جدًا لتسمية الحقول، وقيود، وقواعد واجهة. على الرغم من أن واجهة برمجة التطبيقات v3 الخاصة بـ WeChat Pay يُقال إنها "RESTful"، إلا أنه لا يوجد معيار موحد.
على سبيل المثال، خذ استعلام الترحيل كمثال. يبدو أن الحقول هي نفسها، وتتكون من الإزاحة ، والمؤشر ، والصفحة ، والحد + البيانات ، والعدد الإجمالي ، والمؤشر التالي، ومع ذلك، فإن حقول الإزاحة والمؤشر والصفحة والحد لبعضها الواجهات عبارة عن معلمات اختيارية، بعضها مطلوب، تبدأ بعض قيم الصفحة من 0 ، وبعضها يبدأ من 1 ؛ سيتم إرجاع حقل next_cursor بالتأكيد، ولكن لن يتم إرجاع بعضها، وسيتم إرجاع البعض الآخر فقط في ظل ظروف معينة. هناك أكثر من اثنتي عشرة واجهة استعلام ترحيل صفحات، ولكن هناك سبعة أو ثمانية هياكل بيانات ترحيل صفحات، في هذه الحالة، من الصعب تجريد فئة أساسية مشتركة.
بالإضافة إلى ذلك، يتم كتابة نفس الشيء بشكل مختلف في الواجهات المختلفة؛ يتم تمثيل بعض المصفوفات كـ JSON، بينما يتم تمثيل البعض الآخر كسلاسل؛ هناك العديد من المواقف "الغريبة" مثل هذا.
قام هذا المشروع باستخلاص بعض الفئات الأساسية العامة قدر الإمكان وقام بتغليف JsonConverter المخصص في العديد من السيناريوهات الغريبة.
نظرًا لأن WeChat لديه العديد من خطوط أعمال المنتجات، فإن العديد من الشركات تتطلب أيضًا متطلبات مسبقة للمتابعة تقريبا بما فيه الكفاية.
يتم حزم هذا المشروع بما يتوافق تمامًا مع وثائق التطوير الرسمية المقدمة من WeChat، ويتم استخدام الأدوات الآلية لضمان دقة نتائج التعبئة. ومع ذلك، فإن وثائق WeChat نفسها ذات جودة منخفضة نسبيًا، لذا فإن الأخطاء لا مفر منها.
نظرًا لأن WeChat يقوم بتحديث واجهة برمجة التطبيقات الخاصة به بشكل متكرر جدًا، بالنسبة لـ WeChat Payment أو WeChat Enterprise التي توفر سجلات التحديث الرسمية، فإن هذا المشروع سيتحقق بانتظام من وجود تحديثات للأنظمة الأساسية الأخرى غالبًا ما يتم تحديثها بهدوء، مما يربك الجميع. إذا واجهت مشكلات أثناء الاستخدام بسبب واجهة غير صحيحة أو تعريف نموذج غير صحيح، فلا تتردد في إثارة مشكلة.
| اسم المشروع | مقدمة المشروع | عنوان المشروع |
|---|---|---|
| CoreShop | نظام المركز التجاري الأساسي: نظام .NET Mall الذي يدعم التخطيط المرئي. | |
| المشرف.NET | إطار عمل تطوير الأذونات العالمية .NET يقف على أكتاف العمالقة. |
ملاحظة: الحالات المذكورة أعلاه كلها من أطراف ثالثة هذا المشروع لا يقدم أي ضمان لمشاريعه وهو فقط للتعداد والعرض. إذا كان لديك مشروع يستخدم هذه المكتبة أيضًا وترغب في إضافته إلى قائمة الحالات، فيمكنك إرساله في الإصدار (إما مفتوح المصدر أو غير مفتوح المصدر).
يتم تحديث عناوين المستودعات المذكورة أعلاه في وقت واحد ويمكنها قبول طلب الإصدار أو السحب.
يرجى الاطلاع على المساهمة لمعرفة كيفية المساهمة.
يرجى الرجوع إلى CHANGELOG للحصول على تعليمات التحديث التفصيلية.
