يوفر Etsy واجهة برمجة تطبيقات عامة للحصول على البيانات وتحديثها من النظام الأساسي. تسمح أي واجهة برمجة تطبيقات للمطورين بإنشاء تطبيقات مبنية على بيانات وخيارات فريدة لبرنامج أو موقع ويب. وبالمثل ، يستخدم المطورون واجهة برمجة تطبيقات Etsy لإنشاء عمليات تكامل للبائعين والمشترين.
كيفية الحصول على مفتاح Etsy API
لا يتطلب الوصول إلى واجهة برمجة تطبيقات الويب Etsy الكثير من الوقت أو الجهد. تحتاج أولاً إلى الوصول إلى موقع مجتمع مطوري Etsy على الويب ، حيث يمكنك البدء في إنشاء التطبيقات والتكاملات الخاصة بك باستخدام مفتاح API الفريد الخاص بك. اتبع هذا البرنامج التعليمي Etsy API أدناه لمعرفة كيفية الوصول إلى واجهة البرمجة هذه.
الخطوة 1 – قم بإنشاء حساب
انتقل إلى موقع Etsy Developers Community وقم بتسجيل حساب جديد أو تسجيل الدخول باستخدام حسابك الحالي.
الخطوة 2 – ضبط إعدادات الأمان
قبل إنشاء تطبيقك الأول ، تتطلب الخدمة إعداد مصادقة ثنائية.
اتبع الرابط وستتم إعادة توجيهك إلى صفحة معلمات الأمان.
يمكنك الاختيار من بين عدة خيارات: تثبيت تطبيق Google Authenticator على جهازك المحمول لتأكيد وصولك برمز التأكيد المحدد الخاص بك من خلال التطبيق. بعد النقر على هذا الخيار ، يُعرض عليك تنزيل التطبيق وتوصيله ببوابة مطوري Etsy عبر مسح رمز الاستجابة السريعة.
يمكنك أيضًا اختيار التحقق عبر مكالمة هاتفية أو رسالة نصية قصيرة. عند تحديد هذا الخيار ، يجب عليك إدخال رقم هاتفك في الحقل المقابل. بعد النقر فوق “التالي” ، ستتلقى رمز رسالة نصية قصيرة أو مكالمة هاتفية تلقائية ، حسب الخيار الذي تختاره.
الخطوة 3 – إنشاء تطبيق
بعد تعديل متطلبات الأمان ، يمكنك البدء في إنشاء تطبيقك الأول. تحتاج أولاً إلى ملء النموذج لوصف طلبك المحتمل.
أكمل Captcha واضغط على قراءة الشروط وإنشاء التطبيق.
سيُعرض عليك قراءة شروط وأحكام Etsy API في النافذة المنبثقة. تعرف على المستند لتكون على دراية بالمتطلبات والقيود أثناء استخدام واجهة البرمجة. ضع علامة في المربع واضغط على إنشاء التطبيق.
الخطوة 4 – احصل على بيانات اعتماد API الخاصة بك
بعد الموافقة على الشروط والأحكام ، ستتمكن من الوصول إلى مفتاح API والسرية.
كيفية استخدام Etsy API
عند إنشاء تطبيق لأول مرة ، يكون لديه وصول مؤقت افتراضي إلى خدمات Etsy أثناء عملية التطوير. يتميز الوصول المؤقت بالوظائف التالية:
الوصول للقراءة إلى أي مصادر مفتوحة وغير مصدق عليها ، مثل المتاجر وخزانات الخزانة.
وصول موثق (قراءة وكتابة) إلى البيانات العائدة لمالك التطبيق. يمنح هذا الوصول فرصة لقراءة البيانات الشخصية مثل الإيصالات والفواتير ، وكذلك إنشاء قوائم متجر أو تحريرها أو حذفها. إذا كنت بحاجة ، يمكنك التقدم بطلب للوصول لمجموعة صغيرة من مستخدمي الاختبار بالإضافة إلى مالك التطبيق.
تقدم Etsy أيضًا وصولاً كاملاً يوفر خيارًا للوصول المعتمد إلى بيانات أعضاء Etsy غير المحدودة. إذا كان التكامل الذي تقوم بتطويره لا يحتاج إلى مثل هذه الامتيازات ، يمكنك فقط استخدام التطبيق في الوضع المؤقت.
إذا كنت لا تزال ترغب في الوصول الكامل إلى التطبيق الخاص بك ، فيجب عليك أولاً استخدام الوصول المؤقت لتطوير التطبيق وتشغيله بشكل صحيح ثم التحقق مما إذا كنت تتناسب مع متطلبات النظام الأساسي للوصول الكامل .
أمثلة Etsy API
Etsy مراجعات API
تتميز منصة Etsy بنظام التعليقات الذي يسمح للمشترين والبائعين بترك تعليقات لبعضهم البعض حول معاملات محددة على Etsy. يوفر عدة طرق للعثور على أنواع محددة من التعليقات المتاحة على النظام الأساسي. هم ، على سبيل المثال ، findAllUserFeedbackAsAuthor, findAllUserFeedbackAsBuyer, findAllUserFeedbackAsSeller,والعديد من الآخرين.
فيما يلي مثال على طريقة findAllFeedbackFromBuyers ، والتي تتيح لك الحصول على تعليقاتك من العملاء واستخدامها.
| اسم الطريقة | findAllFeedbackFromBuyers |
| ملخص | تُرجع مجموعة من كائنات FeedBack المرتبطة بمستخدم. هذا هو في الأساس الاتحاد بين التابعين findAllUserFeedbackAsBuyer و findAllUserFeedbackAsSubject. |
| طريقة HTTP | احصل على |
| URI | / المستخدمين /: user_id / feedback / from-المشترين |
واجهة برمجة تطبيقات الدفع Etsy
تمثل واجهة برمجة تطبيقات الدفع والمعاملات جزءًا من أدوات Etsy Seller. تنقسم جميع المبيعات والمشتريات التي تتم من خلال منصة Etsy إلى 3 مصادر رئيسية: الطلبات والإيصالات والمعاملات. و API الدفع يمثل دفع يجعل مع المدفوعات و Etsy.
Etsy قائمة API
قوائم Etsy هي عناصر متاحة للبيع. كل قائمة مرتبطة بمستخدم ومتجر (المستخدم الذي يمتلك هذا المتجر). تتميز القوائم بالسعر والكمية المرفقة بها ، وعندما يتم بيعها ، يتعين على صاحب المتجر تجديد العناصر قبل أن يمكن بيعها مرة أخرى. إنه يتميز بطرق البحث عن قوائم الفئات المختلفة واستعادتها ، وكذلك لإنشاء القوائم وحذفها. تشمل هذه الفئات: نشطة ، ومثيرة للاهتمام ، وشائعة ، وإيصالات ، وقوائم أخرى. يمكن لـ Etsy List API الحصول على عناصر البائع findAllShopListingsActiveبالطريقة التي تعثر على جميع القوائم النشطة التي تنتمي إلى متجر.
وثائق Etsy API
يقدم موقع مجتمع مطوري Etsy قسمًا مطورًا للوثائق لأعضائه. يوجد دليل أساسيات للمطورين الجدد على واجهة برمجة Etsy لمساعدتهم على بدء العمل معها. القسم الفريد من بوابة Etsy Developer API هو قسم المناقشة . يمكن للجميع المشاركة في المناقشة لطلب المساعدة ومشاركة خبراتهم وقضاياهم.