حُدّثت النسخة الفرنسية من هذه المقالة منذ ترجمتها. قراءة النسخة الفرنسية
اربط أداتك عبر الـ API
برنامجك ليس في القائمة؟ أنشئ رمز استيراد واجعل أداتك الخاصة ترسل عقاراتك وحجوزاتك ومهامك، عبر المصدر المخصّص.
فيديو هذا الدليل قادم قريبًا.
يغذّي المصدر المخصّص (API) The Big One من أي أداة: برنامجك الداخلي، أو جدول بيانات مؤتمت، أو أداة لا نعرفها. ترسل أداتك العقارات والحجوزات والمهام وأسماء جدول العمل بطلب بسيط. يبيّن لك هذا المقال ما تجهّزه وما تنقله إلى الشخص الذي سينفّذ الربط. خصّص 5 دقائق من جهتك.
برنامجك موجود في صفحة التكاملات؟ الأفضل ربطه بلا تطوير: اربط برنامج الإدارة الخاص بك.
ما الذي يزامنه الاتصال
| البيانات | الاتجاه | ملاحظة |
|---|---|---|
| العقارات | من أداتك إلى The Big One | العقار الغائب عن إرسال لا يُحذف أبدًا |
| الحجوزات | من أداتك إلى The Big One | تُلغى فقط إذا أعلنت أداتك فترة كاملة |
| المهام | من أداتك إلى The Big One | المهمة التي بدأت أو انتهت أو اعتُمدت لا يُكتب فوقها أبدًا |
| أسماء جدول العمل | من أداتك إلى The Big One | تُطابَق مع الحسابات الموجودة؛ ولا يُنشأ أي حساب |
قبل أن تبدأ
- أنت مدير النظام: صفحة التكاملات خاصة بمدير النظام.
- هناك شخص يعرف كتابة برنامج صغير يرسل البيانات: مطوّرك، أو ناشر أداتك.
- لكل عقار وحجز ومهمة في أداتك معرّف لا يتغيّر. وهو ما يمنع إنشاء أي تكرار.
إنشاء رمز الاستيراد
خطوة بخطوة
- 1
افتح الإعدادات ‹ سير العمل والتكاملات ‹ التكاملات.
- 2
في أعلى الصفحة، انقر على عامل التصفية «المطوّرون». هناك تجد بطاقة «مصدر مخصّص (API)».
- 3
انقر على إنشاء رمز. تُفتح نافذة «رمز الاستيراد الخاص بك».
- 4
انقر على نسخ الرمز. تظهر الرسالة «تم نسخ الرمز.».
- 5
احفظ الرمز في مكان آمن ثم أغلق النافذة. تحمل البطاقة العبارة «رمز نشط».
نقل المعلومات إلى مطوّرك
خطوة بخطوة
- 1
في البطاقة، بجانب «عنوان الإرسال:»، انقر على نسخ. تظهر الرسالة «تم نسخ العنوان.».
- 2
انقر على عرض التوثيق. تصف الصفحة العنوان والترويسات ومثالًا كاملًا وقواعد الاستيراد والحدود.
- 3
أرسل إلى مطوّرك عنوان الإرسال ورابط التوثيق، وأرسل الرمز عبر قناة آمنة.
القواعد التي يجب معرفتها قبل كتابة البرنامج:
| القاعدة | معناها |
|---|---|
| معرّف لكل عنصر | يُعرف كل عنصر بمعرّفه: إعادة إرسال المحتوى نفسه لا تنشئ أي تكرار |
| عقار غائب عن إرسال | لا يُحذف أبدًا: المعتمد هو قيمة «نشط» المرسلة فقط |
| بياضات العقار | في كل إرسال يُستبدل جزء البياضات من البطاقة كاملًا: ما أُدخل يدويًا يُكتب فوقه |
| مهمة بدأت بالفعل | لا يُكتب فوقها أبدًا: تُستكمل حقولها الفارغة فقط |
التحقق من عمليات الاستيراد
خطوة بخطوة
- 1
في بطاقة «مصدر مخصّص (API)» اقرأ سطر «آخر استيراد:». يذكر تاريخ آخر إرسال وصل.
- 2
افتح «آخر 30 عملية استيراد». يعدّ كل سطر، حسب نوع البيانات، العناصر المنشأة والمحدَّثة والمحتفَظ بها.
- 3
هل يشير سطر إلى أخطاء؟ افتحه لقراءة التفاصيل ثم انقلها إلى مطوّرك.
إلغاء الرمز
افعل ذلك إذا تسرّب الرمز، أو عندما تغيّر أداتك.
خطوة بخطوة
- 1
في البطاقة انقر على إلغاء. تُفتح نافذة «إلغاء الرمز؟».
- 2
انقر على إلغاء الرمز. تظهر الرسالة «تم إلغاء الرمز: سيتم رفض الطلبات القادمة.».
- 3
لإعادة ربط أداتك انقر من جديد على إنشاء رمز وأعطِ الرمز الجديد لمطوّرك.
الأسئلة الشائعة
هل أحتاج إلى مطوّر؟
نعم. ينتظر المصدر المخصّص بيانات يرسلها برنامج. بلا مطوّر، اربط برنامجًا من صفحة التكاملات أو رابط iCal.
هل يمكن ربط عقار مستورد عبر الـ API بإعلان من تكامل آخر؟
لا. تعثر عليه أداتك بمعرّفه في كل إرسال: لا يمكن ربطه بإعلان من تكامل آخر.
هل يمكن إشعار أداتي عند انتهاء مهمة؟
نعم. ضمن عامل التصفية «المطوّرون» تتيح بطاقة «وصول المطوّرين» إضافة عنوان يُشعَر عند إسناد مهمة أو بدئها أو انتهائها أو اعتمادها.
ماذا يحدث إذا أنشأت رمزًا جديدًا؟
يُلغى الرمز القديم: تُرفض الإرسالات التي تستخدمه. أعطِ الرمز الجديد لمطوّرك.
هل ينشئ الاستيراد حسابات عمال النظافة؟
لا. لا ينشئ الاستيراد أي حساب: الأسماء التي لا مطابق لها تُعاد إلى أداتك لتدعو أنت الشخص.