مفتاح API يتيح لبرنامج التصرف باسم حسابك. أداة سطر الأوامر، و REST API، وخطوة في Zapier، أو السكربت الخاص بك، كلها تستخدم مفتاحًا. أما تطبيقات الذكاء الاصطناعي التي تدعم تسجيل الدخول، مثل Claude و ChatGPT، فلا تحتاج إلى مفتاح إطلاقًا.
أنشئ مفتاحًا
افتح الإعدادات واختر مفاتيح API.
- اكتب اسمًا في الحقل بجانب مفتاح جديد. سمِّه باسم المكان الذي سيُستخدم فيه، مثل "cli on my laptop" أو "zapier".
- انقر إنشاء مفتاح.
- انسخ المفتاح فورًا. يبدأ بـ
ag_live_ولا يظهر كاملًا إلا مرة واحدة. بعد ذلك تعرض القائمة أحرفه الأولى، وتاريخ إنشائه، وآخر استخدام له.
احفظ المفتاح في مدير كلمات المرور أو في إعدادات الأسرار في أداتك. ولا تضعه أبدًا في مستند مشترك أو لقطة شاشة أو محادثة.
استخدم المفتاح
تطلب أداة سطر الأوامر المفتاح مرة واحدة عند تشغيل npx argorant login وتحفظه على جهازك. أما مع REST API فترسله في ترويسة مع كل طلب.
curl https://app.argorant.com/api/mcp/account \
-H "Authorization: Bearer ag_live_..."يعرض هذا الاستدعاء الأول خطتك ورصيدك، وهي طريقة جيدة للتأكد من أن المفتاح يعمل. ويسرد مقال مفاتيح API و REST API أهم نقاط النهاية، ويغطي مقال أداة Argorant CLI أداة سطر الأوامر.
مفتاح لكل أداة
خصص لكل أداة ولكل شخص مفتاحه الخاص. بذلك ترى أي مفتاح استُخدم ومتى، ويمكنك إيقاف أحدها دون تعطيل الباقي. تتشارك المفاتيح أرصدة حسابك، فلا يملك أي مفتاح رصيدًا خاصًا به. ولكل مفتاح حد سرعة خاص، ولعمليات البحث حدود يومية خلال الفترة التجريبية. ويعرض مقال حدود المعدل والحصص اليومية الأرقام لكل خطة.
التدوير والإلغاء
لاستبدال مفتاح، أنشئ المفتاح الجديد أولًا، وأدخله في الأداة، وتأكد من أنه يعمل، ثم انقر إلغاء بجانب المفتاح القديم. يسري الإلغاء فورًا، ويُرفض الطلب التالي بالمفتاح القديم.
إذا وصل مفتاح إلى مكان لا ينبغي أن يكون فيه، مثل مستودع كود عام أو شاشة مشتركة، فألغِه فورًا وأنشئ مفتاحًا جديدًا. ثم راجع عمليات التصدير الأخيرة لترى ما إذا كان قد جرى شيء لم تبدأه أنت. ويضم مقال ماذا تفعل إذا تسرب مفتاح API قائمة التحقق الكاملة.
Webhooks
أسفل المفاتيح يمكنك إضافة webhook، فيستدعي Argorant عنوانك عند حدوث شيء ما، مثل جاهزية تصدير، أو اكتمال تعبئة قائمة، أو وصول رد، أو إيقاف حملة مؤقتًا. الصق العنوان تحت Webhook جديد، واختر الأحداث، وانقر إضافة Webhook. كل استدعاء موقّع، فيستطيع خادمك التحقق من أنه صادر منا. ويوضح مقال Webhooks محتوى كل حدث.
