إعداد مفتاح X API الخاص بك

​

الخطوة 1: إنشاء حساب X Developer الخاص بك

1

سجّل الدخول إلى Developer Console

انتقل إلى console.x.com وسجّل الدخول بحسابك على X. راجع دليل البدء من X إذا كنت بحاجة إلى مساعدة.

2

أكمل الإعداد

أكمل إعداد المطور واقبل اتفاقية المطور والسياسات.

3

الوصول إلى وحدة التحكم

أنت الآن في X Developer Console.

​

الخطوة 2: إنشاء تطبيق

1

انتقل إلى Apps

في Developer Console، انتقل إلى Apps.

2

أنشئ التطبيق

في لوحة تحكم App، انقر على Create App (راجع مستندات إعداد التطبيق من X للتفاصيل). أدخل اسم التطبيق (عادةً اسم علامتك التجارية). سيظهر هذا الاسم في شاشة تفويض OAuth عندما يربط المستخدمون حساب X الخاص بهم.

3

اختر البيئة

اختر بيئة Production في القائمة المنسدلة.

4

أغلق نافذة بيانات الاعتماد الأولية

ستُنشئ X عدة بيانات اعتماد. تجاهل هذه البيانات وأغلق هذه النافذة.

​

الخطوة 3: تكوين أذونات التطبيق

1

افتح إعدادات تطبيقك

ضمن “Apps”، حدّد موقع التطبيق الجديد (قم بتحديث الصفحة إذا لم يظهر)، ثم انقر عليه لعرض تفاصيله.ضمن User authentication settings، انقر على Set up.

2

عيّن أذونات التطبيق

ضمن App permissions، اختر Read and write and Direct message. هذا مطلوب لدعم كامل الميزات، بما في ذلك النشر والرسائل المباشرة.

3

عيّن نوع التطبيق

ضمن Type of App، اختر Web App, Automated App or Bot. هذا هو الخيار الصحيح لتكاملات الخوادم مثل Ayrshare.

4

عيّن عناوين URL للاستدعاء والموقع الإلكتروني

ضمن App info:

• Callback URL: أضف عنواني URL الاستدعاء التاليين:
  • https://profile.ayrshare.com/social-accounts
  • https://app.ayrshare.com/social-accounts
• Website URL: https://app.ayrshare.com

لا تتخطَّ هذه الخطوة. عناوين URL الاستدعاء هذه مطلوبة لتدفق ربط OAuth. عندما يُخوّل المستخدمون النهائيون اتصال X، تُعيدهم X إلى أحد هذه العناوين لإكمال عملية الربط. إذا كانت هذه مفقودة، سيفشل تدفق OAuth مع خطأ 403 Callback URL not approved.

5

احفظ إعداداتك

انقر على Save. يمكنك تجاهل النافذة المنبثقة لـ OAuth 2.0، حيث ستستخدم فقط 2 من مفاتيح OAuth 1.0 (API Key وAPI Secret).

مهم: عيّن الأذونات قبل الربط. تحدد الأذونات التي تختارها هنا ما يمكن لتطبيقك القيام به. إذا غيّرت الأذونات بعد ربط حسابك على X عبر OAuth، ستحتاج إلى إعادة الربط بحيث يرث Access Token الجديد الأذونات المُحدَّثة.

1. API Key (المعروف أيضًا بـ Consumer Key، مُعرِّف تطبيق X)
2. API Secret (المعروف أيضًا بـ Consumer Secret)

​

الخطوة 4: شراء أرصدة X API

1

انتقل إلى الفوترة

في Developer Console، انقر على Billing → Credits في الشريط الجانبي الأيسر.

2

اشترِ الأرصدة

اشترِ الأرصدة (الحد الأدنى هو $5، وهو كافٍ لمئات من استدعاءات API). كل استدعاء API هو جزء من سنت واحد، لذا يجب أن تكون التكلفة ضئيلة لمعظم المستخدمين.

3

فعّل الشحن التلقائي

يمكنك تفعيل auto-recharge لتجنّب انقطاع الخدمة، وإدارة سقف الإنفاق بتعيين الحد الأقصى للمبلغ الذي يمكنك إنفاقه في دورة الفوترة.

​

الخطوة 5: تحديث استدعاءات Ayrshare API الخاصة بك

1. API Key (المعروف أيضًا بـ Consumer Key، مُعرِّف تطبيق X)
2. API Secret (المعروف أيضًا بـ Consumer Secret)

​

مرجع الترويسات

​

أمثلة الكود

curl -X POST https://api.ayrshare.com/api/post \
  -H "Authorization: Bearer YOUR_AYRSHARE_API_KEY" \
  -H "X-Twitter-OAuth1-Api-Key: your_api_key" \
  -H "X-Twitter-OAuth1-Api-Secret: your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{"post": "Hello from my own X App!", "platforms": ["twitter"]}'

const response = await fetch("https://api.ayrshare.com/api/post", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_AYRSHARE_API_KEY",
    "Content-Type": "application/json",
    "X-Twitter-OAuth1-Api-Key": process.env.X_API_KEY,
    "X-Twitter-OAuth1-Api-Secret": process.env.X_API_SECRET,
  },
  body: JSON.stringify({
    post: "Hello from my own X App!",
    platforms: ["twitter"],
  }),
});

import os
import requests

headers = {
    "Authorization": "Bearer YOUR_AYRSHARE_API_KEY",
    "Content-Type": "application/json",
    "X-Twitter-OAuth1-Api-Key": os.environ["X_API_KEY"],
    "X-Twitter-OAuth1-Api-Secret": os.environ["X_API_SECRET"],
}

response = requests.post(
    "https://api.ayrshare.com/api/post",
    headers=headers,
    json={"post": "Hello from my own X App!", "platforms": ["twitter"]},
)

​

ترحيل الملفات الشخصية الموجودة (Business وEnterprise)

{
  "domain": "your-domain",
  "profileKey": "...",
  "privateKey": "...",
  "twitterApiKey": "YOUR_X_CONSUMER_KEY",
  "twitterApiSecret": "YOUR_X_CONSUMER_SECRET"
}

​

تحقق من الإعداد

​

كيف تعمل أسعار X API

​

فوائد استخدام مفتاح X API الخاص بك

• تجربة OAuth ذات علامة تجارية: يرى المستخدمون اسم تطبيقك وعلامتك التجارية عند تفويض الوصول إلى X.
• حدود معدل مخصصة: يخضع استخدامك لـ API لحدود حساب X Developer الخاص بك، بشكل منفصل عن مستخدمي Ayrshare الآخرين. يمكنك مراقبة استخدامك في X Developer Console ومراجعة مستندات حدود معدل X API.
• التحكم في بيانات الاعتماد: يبقى API Key وSecret الخاصان بك في حساب X Developer الخاص بك. لا يخزن Ayrshare مفاتيحك السرية.
• قابلية النقل: لأن المستخدمين يُصادقون بتطبيق X الخاص بك، يبقى تكاملك تحت سيطرتك الكاملة.
• رؤية الاستخدام: تعرض لوحة تحكم X Developer الخاصة بك طلبات API وحدود المعدل واستخدام الأرصدة.

​

الأمان

• لا يتم تخزين API Key وAPI Secret من قبل Ayrshare.
• للاطلاع على أفضل ممارسات الأمان العامة، راجع دليل أمان المصادقة من X.

​

الأسئلة الشائعة

​

استكشاف الأخطاء وإصلاحها

​

تحتاج إلى مساعدة؟