للمطورين
قراءة العملاء بمفتاح API
أنشئ مفتاح مطوّر للقراءة فقط واجلب عملاء مساحة العمل وحملاتها عبر HTTPS من كودك.
يتيح مفتاح المطوّر لكودك قراءة العملاء والحملات دون شاشات بوب أب. المفتاح للقراءة فقط ولا يستطيع تغيير شيء. هذه المقالة للمطورين.

ما تحتاجه
- أن تدير الإعدادات في مساحة العمل. لا يرى مفاتيح API وينشئها إلا من يدير الإعدادات.
أنشئ مفتاحًا
- افتح مفاتيح API من القائمة الجانبية.
- اضغط إنشاء مفتاح وسمِّ المفتاح باسم ما يستخدمه، ثم اضغط إنشاء.
- انسخ المفتاح. انسخه الآن واحفظه في مكان آمن. يظهر هذه المرة فقط؛ إن فُقد فأزله وأنشئ غيره.
استدعِ الواجهة
- أرسل المفتاح في ترويسة Authorization: Bearer مع كل طلب. يُجاب حتى 120 طلبًا في الدقيقة لكل مفتاح، وبعدها يكون الرد 429.
- تأتي العملاء الأقدم أولًا، حتى 200 في الصفحة. قيمة next في الرد تجلب الصفحة التالية؛ احتفظ بآخرها واطلب لاحقًا لتحصل فقط على العملاء الذين وصلوا بعدها.
- تأتي الحملات مع حالتها وموقعها.
- يُستبعد العملاء التجريبيون.
احذف مفتاحًا
اضغط «حذف» بجانبه. تمت إزالة المفتاح. تُرفض الشيفرة التي تستخدمه من الآن.
إشعار لحظة وصول العميل
الواجهة للقراءة حين يطلب كودك. ولتستقبل كل عميل جديد لحظة وصوله أضف ويب هوك. راجع الويب هوك.
مواضيع ذات صلة
آخر تحديث: ١٢ أكتوبر ٢٠٢٦