ArgorantDocs

المصادقة

مفاتيح API، والعنوان الأساسي، وما يسمح به كل نطاق صلاحيات للمفتاح، وكيف يسجّل وكلاء الذكاء الاصطناعي الدخول دون مفتاح.

العنوان الأساسي

Text
https://app.argorant.com/api/v1

مفاتيح API

سجّل الدخول على app.argorant.com/profile وأنشئ مفتاحًا ضمن مفاتيح API. تبدأ المفاتيح بـ ag_live_ وتُعرض مرة واحدة فقط. سمِّ كل مفتاح باسم الشيء الذي يستخدمه، مثل zapier أو ci أو laptop، حتى تتمكن من إلغاء أحدها دون تعطيل الباقي.

أرسل المفتاح مع كل استدعاء:

Shell
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، تمامًا مثل العناصر غير الموجودة.

في هذه الصفحة