دقيقتان، ويستحقّ أن يُفعل قبل أيّ شيء آخر: فمعظم مشكلات التكامل اللاحقة تنتهي إلى واحد من الأمرين اللذين يثبتهما هذا.
1. أنشئ مفتاحاً
«إنشاء مفتاح» في لوحة التحكم. ترى المفتاح كاملاً مرّة واحدة. ضعه حيث يقرؤه كودك من البيئة لا من ملفّ داخل المستودع.
2. اسأل عمّا لديك
curl "https://makehybrid.com/linkedin/connect/accounts" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
وجود جواب يعني أنّ المفتاح صالح وأنّ الخطة سارية، والقائمة العائدة هي كلّ حساب LinkedIn ربطته مؤسستك. أمران أُثبتا، ومعهما المُدخل الوحيد الذي يحتاجه كلّ استدعاء آخر — معرّف الحساب — في طلب واحد لا يمسّ LinkedIn البتّة.
3. تعلّم شكل الأخطاء الآن
{"type":"errors/payment_required","status":402,"detail":"..."}
- 401 — المفتاح مفقود أو خاطئ أو مُلغى.
- 402 — الخطة غير مدفوعة، أو انتهت الفترة التجريبية.
- 404 — غير موجود، أو ليس لك. الجواب نفسه عن قصد.
- 429 — طلبات أكثر من اللازم، أو LinkedIn تكبح الحساب.
- 503 — القفزة التي أمام LinkedIn لم تجب؛ والجسم يحمل الحالة العارية التي رآها.
اكتب معالجاً واحداً بإزاء هذا الشكل تغطِّ كلّ مسار في الفهرس. وحقل detail مكتوب ليُعرَض على إنسان، فعرضه هو الصواب في العادة.
أسئلة شائعة
هل أستطيع إجراء الاستدعاء الأول من دردشة بدلاً من ذلك؟
نعم. اربط مساعدك واسأله أي الحسابات متصلة؛ فيُجري استدعاءً من النوع نفسه ويقرأ لك الجواب. ومع ذلك يستحق أن تفعله مرة بيدك، لأن شكل الخطأ الذي تراه هنا هو الذي سيقرؤه وكيل الذكاء الاصطناعي أيضاً.
هل تحتاج غرفة المشروع إلى هذا المفتاح؟
ليس لفتح غرفة أو سؤال وكيل ذكاء اصطناعي مدمج. وحده وكيلك الذي يتصرف على LinkedIn يحتاج إلى مفتاح، والغرفة تُنشئ ذلك المفتاح بنفسها.