المصادقة
مفاتيح API، والعنوان الأساسي، وما يسمح به كل نطاق صلاحيات للمفتاح، وكيف يسجّل وكلاء الذكاء الاصطناعي الدخول دون مفتاح.
العنوان الأساسي
https://app.argorant.com/api/v1مفاتيح API
سجّل الدخول على app.argorant.com/profile وأنشئ مفتاحًا ضمن مفاتيح API. تبدأ المفاتيح بـ ag_live_ وتُعرض مرة واحدة فقط. سمِّ كل مفتاح باسم الشيء الذي يستخدمه، مثل zapier أو ci أو laptop، حتى تتمكن من إلغاء أحدها دون تعطيل الباقي.
أرسل المفتاح مع كل استدعاء:
curl "https://app.argorant.com/api/v1/account" \
-H "Authorization: Bearer $ARGORANT_API_KEY"تخبرك الإجابة بالشخص الذي يعمل المفتاح باسمه، وبخطتك، وأرصدتك، وعدد الطلبات التي يمكن للمفتاح إرسالها في الدقيقة، وما تبقى من حدود اليوم. استدعِها قبل أي مهمة كبيرة.
تعمل مفاتيح API خلال الفترة التجريبية لمدة 7 أيام وفي كل الخطط. تقرأ أداة سطر الأوامر المفتاح نفسه من npx argorant login أو من المتغير ARGORANT_API_KEY.
نطاقات الصلاحيات
المفتاح الذي يُنشأ في التطبيق يحمل كل نطاقات الصلاحيات أدناه. أما المفتاح ذو النطاق الأضيق فيتلقى 403 مع الرمز scope_missing عندما يستدعي شيئًا خارج نطاقاته.
| النطاق | يسمح بـ | قد يكلّف |
|---|---|---|
argorant:read_counts | العدّ، وقوائم الكلمات، والحساب، وقراءة الحملات وصندوق الوارد وصناديق البريد وWebhooks | لا شيء |
argorant:search_segments | معاينات مخفية البيانات للأشخاص والشركات | لا شيء |
argorant:manage_lists | القوائم، والحملات، والإطلاق، والإجابة على الردود، والحالات، وصناديق البريد، وقائمة الحظر، وWebhooks، وطلبات صناديق البريد | طلبات صناديق البريد تكلّف مالًا، بعد موافقتك |
argorant:unlock_contacts | الكشف، وأرقام الهواتف، وإثراء بيانات الأشخاص، والباحث عن البريد الإلكتروني | أرصدة |
argorant:create_exports | عمليات التصدير وتصدير القوائم | أرصدة |
argorant:verify_emails | فحص قوائمك الخاصة | أرصدة، نصف رصيد لكل فحص جديد |
وكلاء الذكاء الاصطناعي يسجّلون الدخول ولا يرون المفتاح أبدًا
يتصل عملاء MCP مثل Claude وChatGPT بـ https://mcp.argorant.com/mcp ويسجّلون الدخول عبر OAuth 2.1 (رمز التفويض مع PKCE). ويعملون لصالح حسابك بنطاقات الصلاحيات التي توافق عليها، ولا يدخل مفتاح API الخاص بك إلى أي محادثة أبدًا. راجع ربط عميل.
الصلاحيات داخل مساحة العمل
يعمل المفتاح باسم الشخص الذي أنشأه. لا يرى المالكون والأعضاء إلا مساحة عملهم. بعض الإجراءات، مثل طلب صناديق البريد، مخصصة لمالك مساحة العمل؛ ويتلقى العضو 403 مع رسالة واضحة توضح ذلك. العناصر التابعة لمساحات عمل أخرى تُجيب دائمًا بـ 404 not_found، تمامًا مثل العناصر غير الموجودة.