سجّل الدخول إلى ماركت دوجو
انتقل إلى صفحة ملفك الشخصي، ودوّن بريدك الإلكتروني ومفتاح واجهة برمجة تطبيقات Market Dojo.
انتقل إلى https://secure.marketdojo.com/api/v1/documentation
راجع نقاط النهاية المتاحة لفهم كيفية عمل واجهة برمجة التطبيقات (API).
لاحظ أنه يمكنك تجربة واجهة برمجة التطبيقات (API) مباشرةً من صفحة التوثيق.
يوفر Market Dojo عددًا من نقاط نهاية API المصممة للاستخدام مع أدوات إعداد التقارير مثل Power BI.
بالإضافة إلى نقاط النهاية المذكورة أدناه، يمكن الاطلاع على وثائق نقاط نهاية واجهة برمجة التطبيقات v1 على الرابط التالي: https://gl.marketdojo.com/api/v1/documentation
يجب تقديم الطلبات إلى أحد الجهات التالية:
- https://secure.marketdojo.com، أو
- نطاق شركتك المُهيأ (على سبيل المثال، https://acme.marketdojo.com أو https://procurement.acme.com).
يتم حظر الطلبات التي تحتوي على رأس مضيف لأي نطاق آخر.
تأخذ واجهات برمجة التطبيقات الخاصة بالإبلاغ معيارين قياسيين:
البريد الإلكتروني : البريد الإلكتروني للمستخدم الذي يقوم بالوصول إلى نقطة النهاية
api_key : مفتاح API الخاص بالمستخدم (يمكن العثور عليه في صفحة ملفه الشخصي في تطبيق ماركت دوجو)
في حالة استخدام نقاط النهاية من سطر الأوامر، قد يكون من الضروري وضع عنوان URL بين علامتي اقتباس.
curl ' https://secure.marketdojo.com/api/v2/reports/contracts?email=email&api_key=api_key '
يتم إرجاع النتائج بتنسيق JSON.
هل المستخدم عضو في المجموعة (الافتراضية)؟ إذا لم يكن كذلك، فسيتلقى خطأ 403.
يلزم وجود مفتاح API لاستخدام واجهة برمجة التطبيقات (API).
اتبع التعليمات هنا للحصول على مفتاح API الخاص بك.
إذا لم تجد خيار إنشاء أو عرض مفتاح API الخاص بك، فيرجى مطالبة مضيفك الرئيسي بتمكين واجهة برمجة التطبيقات (API) في صفحة الإدارة > التكاملات.
https://secure.marketdojo.com/api/v2/reports/companies?email=email&api_key=key
ستعيد هذه النقطة النهائية معلومات حول شركة المستخدم.
https://secure.marketdojo.com/api/v2/reports/users?email=email&api_key=key
ستعيد هذه النقطة النهائية معلومات حول جميع المستخدمين في الشركة.
https://secure.marketdojo.com/api/v2/reports/contracts?email=email&api_key=key
ستعيد هذه النقطة النهائية تفاصيل العقود التي يمكن للمستخدم الوصول إليها.
https://secure.marketdojo.com/api/v2/reports/events?email=email&api_key=key
ستعيد هذه النقطة النهائية تفاصيل الأحداث التي يمكن للمستخدم الوصول إليها لعرضها.
https://secure.marketdojo.com/api/v2/reports/questionnaires/:id?email=email&api_key=key
ستُعيد هذه النقطة النهائية تفاصيل الاستبيان، بما في ذلك الردود التي تم تلقيها.
ملاحظة: يجب استبدال :id برقم تعريف الاستبيان (رقم).
https://secure.marketdojo.com/api/v2/reports/sim_participants?email=email&api_key=key
ستعيد هذه النقطة النهائية تفاصيل المشاركين في حدث إعداد الموردين.
https://secure.marketdojo.com/api/v2/reports/srm?email=email&api_key=key
ستُعيد هذه النقطة النهائية تفاصيل مجموعة إدارة علاقات الموردين (SRM) الخاصة بالمستخدم، بما في ذلك معلومات مثل حسابات srm، وجهات اتصال srm، والأنشطة والأحداث.