> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # إعداد مفتاح X API الخاص بك > دليل خطوة بخطوة لربط بيانات اعتماد X (Twitter) API الخاصة بك مع Ayrshare في 31 مارس 2026، غيّرت X طريقة وصول المنصات الخارجية إلى واجهة برمجة التطبيقات الخاصة بها. نتيجةً لذلك، يجب على كل حساب Ayrshare يُنشر على X عبر Ayrshare أن يُسجّل تطبيق X Developer الخاص به وأن يستخدم API Key وAPI Secret الخاصين به في كل طلب. هذا تغيير على مستوى المنصة تفرضه X ويؤثر على جميع الأدوات الخارجية. **مفاتيح BYO تُعيَّن مرة واحدة لكل منصة (على مستوى الحساب)، وليس لكل عميل أو ملف تعريف فرعي.** تُنشئ **تطبيق X Developer واحدًا** ضمن حساب X الخاص بك، ويُطبَّق نفس **API Key + API Secret** على مستوى الحساب لـ X — يُستخدمان لـ **كل** ملف تعريف فرعي / مستخدم نهائي يربط X ضمن حساب Ayrshare الخاص بك. إذا كانت لديك خطة Business أو Enterprise بمئات من الملفات الفرعية، فأنت **لا** تحتاج إلى تكرار هذا الإعداد لكل منها. تقوم بإعداده مرة واحدة لمنصة X، ثم تمرّر نفس الترويستين على كل طلب. لقد بسّطنا عملية الإعداد لجعل هذا الأمر بسيطًا قدر الإمكان، ويجب أن يستغرق إكماله أقل من 10 دقائق. اتبع دليلنا خطوة بخطوة أدناه، وإذا كنت بحاجة إلى أي مساعدة على طول الطريق، فإن فريقنا هنا للمساعدة. ## الخطوة 1: إنشاء حساب X Developer الخاص بك انتقل إلى [console.x.com](https://console.x.com) وسجّل الدخول بحسابك على X. راجع [دليل البدء من X](https://docs.x.com/x-api/getting-started/getting-access) إذا كنت بحاجة إلى مساعدة. X Developer Console sign-in page أكمل إعداد المطور واقبل اتفاقية المطور والسياسات. أنت الآن في X Developer Console. ## الخطوة 2: إنشاء تطبيق تقوم بإنشاء **تطبيق X Developer واحد فقط لكل حساب Ayrshare**. يُعاد استخدام نفس التطبيق و API Key + API Secret الخاصين به لكل ملف تعريف فرعي / مستخدم نهائي تربطه لاحقًا ضمن حساب Ayrshare الخاص بك. أنت لا تُنشئ تطبيقًا جديدًا لكل عميل. في Developer Console، انتقل إلى **Apps**. Apps page in X Developer Console في لوحة تحكم App، انقر على **Create App** (راجع [مستندات إعداد التطبيق من X](https://docs.x.com/fundamentals/developer-apps) للتفاصيل). أدخل اسم التطبيق (عادةً اسم علامتك التجارية). سيظهر هذا الاسم في شاشة تفويض OAuth عندما يربط المستخدمون حساب X الخاص بهم. Create App button in the X Developer Console اختر بيئة **Production** في القائمة المنسدلة. Production environment selection and credentials popup ستُنشئ X عدة بيانات اعتماد. **تجاهل هذه البيانات وأغلق هذه النافذة.** ## الخطوة 3: تكوين أذونات التطبيق ضمن "Apps"، حدّد موقع التطبيق الجديد (قم بتحديث الصفحة إذا لم يظهر)، ثم انقر عليه لعرض تفاصيله. App details page in the X Developer Console ضمن **User authentication settings**، انقر على **Set up**. User authentication settings, click Set up ضمن **App permissions**، اختر **Read and write and Direct message**. هذا مطلوب لدعم كامل الميزات، بما في ذلك النشر والرسائل المباشرة. App permissions set to Read and write and Direct message ضمن **Type of App**، اختر **Web App, Automated App or Bot**. هذا هو الخيار الصحيح لتكاملات الخوادم مثل Ayrshare. Type of App set to Web App, Automated App or Bot ضمن **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`. App info form with callback URL and website URL filled in انقر على **Save**. يمكنك تجاهل النافذة المنبثقة لـ OAuth 2.0، حيث ستستخدم فقط 2 من مفاتيح OAuth 1.0 (API Key وAPI Secret). **مهم: عيّن الأذونات قبل الربط.** تحدد الأذونات التي تختارها هنا ما يمكن لتطبيقك القيام به. إذا غيّرت الأذونات بعد ربط حسابك على X عبر OAuth، ستحتاج إلى إعادة الربط بحيث يرث Access Token الجديد الأذونات المُحدَّثة. Keys and tokens page showing OAuth 1.0 keys with permission level يرجى التأكد من تخزين هذين المفتاحين: 1. **API Key** (المعروف أيضًا بـ Consumer Key، مُعرِّف تطبيق X) 2. **API Secret** (المعروف أيضًا بـ Consumer Secret) أنت **لا** تحتاج إلى إنشاء Access Tokens يدويًا. يتعامل Ayrshare مع ذلك تلقائيًا عندما تربط حساب X الخاص بك عبر OAuth. ## الخطوة 4: شراء أرصدة X API تستخدم X الآن فوترة API قائمة على الأرصدة، تُشترى عبر لوحة تحكم المطور. في Developer Console، انقر على **Billing → Credits** في الشريط الجانبي الأيسر. Billing Credits page in X Developer Console اشترِ الأرصدة (الحد الأدنى هو \$5، وهو كافٍ لمئات من استدعاءات API). كل استدعاء API هو جزء من سنت واحد، لذا يجب أن تكون التكلفة ضئيلة لمعظم المستخدمين. Credit purchase page in the X Developer Console يمكنك تفعيل **auto-recharge** لتجنّب انقطاع الخدمة، وإدارة سقف الإنفاق بتعيين الحد الأقصى للمبلغ الذي يمكنك إنفاقه في دورة الفوترة. Auto-recharge and spend cap settings in X Developer Console **ستفشل استدعاءات API الخاصة بك دون أرصدة.** واجهة برمجة تطبيقات X تعمل بنظام الدفع لكل استخدام. إذا كان رصيدك صفرًا، فسيُعيد كل طلب API خطأ `402 CreditsDepleted` مع الرسالة "Your enrolled account does not have any credits to fulfill this request." يشمل هذا النشر وقراءة التغريدات والبحث عن المستخدمين. حمّل الأرصدة قبل اختبار تكاملك. راجع [كيف تعمل أسعار X API](#how-x-api-pricing-works) للحصول على تحديث كامل بشأن أسعار X. ## الخطوة 5: تحديث استدعاءات Ayrshare API الخاصة بك في الخطوة 3، حفظت هذين العنصرين بأمان في env أو config أو مدير الأسرار الخاص بك: 1. **API Key** (المعروف أيضًا بـ Consumer Key، مُعرِّف تطبيق X) 2. **API Secret** (المعروف أيضًا بـ Consumer Secret) الآن، أضف بيانات اعتماد X الخاصة بك إلى ترويسات استدعاءات Ayrshare API. **مفاتيحك تبقى خاصة.** لا يتم تخزين API Key وAPI Secret من قبل Ayrshare. ### مرجع الترويسات | الترويسة | القيمة | | ----------------------------- | -------------------------------- | | `X-Twitter-OAuth1-Api-Key` | API Key (Consumer Key) | | `X-Twitter-OAuth1-Api-Secret` | API Key Secret (Consumer Secret) | **كيف تعرف ما إذا كانت أذوناتك غير صحيحة:** * إذا كانت أذونات تطبيقك مُهيَّأة بشكل خاطئ، قد يُعيد طلب API خطأ `403 Forbidden` مع الرسالة: "Your client app is not configured with the appropriate OAuth1 app permissions." إذا رأيت هذا الخطأ، حدّث أذونات تطبيقك إلى **Read and write and Direct message** في X Developer Console، ثم أعِد ربط حساب X الخاص بك عبر OAuth حتى يرث Access Token الجديد الأذونات المُحدَّثة. ### أمثلة الكود ```bash cURL theme={"system"} 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"]}' ``` ```javascript Node.js theme={"system"} 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"], }), }); ``` ```python Python theme={"system"} 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"]}, ) ``` ستستمر أتمتة سير العمل الحالية لديك في العمل طالما أنك تُضمِّن ترويسات API Key وAPI Secret في كل طلب يستهدف X. ### ترحيل الملفات الشخصية الموجودة (Business وEnterprise) إذا كانت لديك ملفات فرعية مرتبطة بالفعل بـ X عبر Ayrshare، فإن هذه الملفات تحتاج إلى إعادة ربط حسابات X الخاصة بها بعد التبديل إلى مفاتيح BYO. هذا لأن رموز الوصول الحالية قد صدرت ضمن تطبيق X الخاص بـ Ayrshare ولا يمكن استخدامها مع مفاتيحك الاستهلاكية (توقيعات OAuth 1.0a مرتبطة بالتطبيق الذي أصدر الرمز). أضف `twitterApiKey` و`twitterApiSecret` إلى جسم استدعاء [generateJWT](/apis/profiles/generate-jwt#body-parameters-13) الخاص بك. يتم تشفير هذه قبل تضمينها في JWT ولا تُعرض للمستخدمين النهائيين. ```json theme={"system"} { "domain": "your-domain", "profileKey": "...", "privateKey": "...", "twitterApiKey": "YOUR_X_CONSUMER_KEY", "twitterApiSecret": "YOUR_X_CONSUMER_SECRET" } ``` هذا هو الطلب الوحيد الذي تذهب فيه مفاتيحك الاستهلاكية في الجسم. جميع طلبات X الأخرى تستخدم الترويسات الموصوفة أعلاه. بعد إنشاء JWT مع تضمين المفاتيح، يحتاج المستخدمون إلى إعادة توصيل حساب X الخاص بهم من خلال صفحة ربط الملف الشخصي. ستُظهر شاشة موافقة OAuth الآن اسم تطبيقك بدلاً من اسم Ayrshare. لتبسيط ذلك، يمكنك: * إلغاء ربط الحسابات برمجيًا عبر [Unlink API](/apis/profiles/unlink-social-network#unlink-a-social-network)، ثم اطلب من المستخدمين إعادة التفويض * استخدام [معلمة `logout`](/apis/profiles/generate-jwt#param-logout) في generateJWT لفرض تسجيل دخول جديد * استخدام [`allowedSocial`](/apis/profiles/generate-jwt#param-allowed-social) لعرض X فقط في صفحة الربط أثناء تدفق الترحيل بعد إعادة الربط، استمر في تضمين ترويستي `X-Twitter-OAuth1-Api-Key` و`X-Twitter-OAuth1-Api-Secret` في كل استدعاء API (النشر، التحليلات، التعليقات، إلخ). بمجرد أن يُعيد ملف تعريف الربط ضمن تطبيق X الخاص بك، ستستخدم جميع المنشورات اللاحقة لذلك الملف الشخصي بيانات اعتمادك. يمكنك التحقق من ذلك بفحص صفحة الاستخدام في [X Developer Console](https://console.x.com) الخاص بك. ### تحقق من الإعداد قم بإجراء استدعاء اختباري عبر Ayrshare API مع ترويساتك الجديدة للتأكد من أن كل شيء يعمل. نقطة النهاية [/analytics/social](/apis/analytics/social) هي اختبار خفيف جيد، حيث لن تُنشئ أي منشورات. ## كيف تعمل أسعار X API سابقًا، كان Ayrshare يغطي تكلفة استخدام X API نيابةً عنك. بموجب النموذج الحالي لـ X، يحتفظ كل عميل Ayrshare بحساب X Developer الخاص به ويدفع لـ X مباشرة مقابل طلبات API التي يُجريها تطبيقه. (حساب X Developer واحد لكل حساب Ayrshare، وليس لكل مستخدم نهائي. جميع ملفاتك الفرعية تشترك في نفس حساب X Developer ورصيد الأرصدة.) نموذج تسعير X هو الدفع لكل استخدام: تشتري الأرصدة في X Developer Console، ويتم خصمها مع إجراء طلبات API. لا حاجة إلى عقود أو اشتراكات. العمليات النموذجية غير مكلفة. على سبيل المثال: | العملية | التكلفة التقريبية | | ------------------------------------- | --------------------------------------------------------------- | | إنشاء منشور (نص فقط) | \~\$0.01 لكل منشور | | إنشاء منشور مع وسائط | \~\$0.02 لكل منشور (تحميل الوسائط وإنشاء المنشور طلبان منفصلان) | | قراءة منشور | \~\$0.005 لكل قراءة | | بحث عن المستخدم | \~\$0.01 لكل بحث | | إرسال رسالة مباشرة (DM) | \~\$0.01 لكل رسالة | | قراءة أحداث DM | \~\$0.01 لكل حدث | | تفاعلات المستخدم (متابعة، إعجاب، إلخ) | \~\$0.015 لكل طلب | للسياق، إذا كنت تنشر حوالي 100 مرة شهريًا، فستكون تكلفة X المباشرة لديك حوالي \$1، والمنشورات مع الوسائط ستكون تقريبًا \$2 شهريًا. تسعير X الدفع لكل استخدام حاليًا في مرحلة تجريبية. الأسعار قابلة للتغيير، وقد تُقدَّم تكاليف إضافية. تحقق دائمًا من Developer Console للحصول على أحدث الأسعار. راجع [تفاصيل معلومات أسعار X](https://docs.x.com/x-api/fundamentals/pricing). نعلم أن هذا يُقدّم تكلفة لم تكن موجودة من قبل، ونريد أن نكون شفافين بشأن ذلك. في الوقت نفسه، يُتيح هذا النموذج أيضًا عدة فوائد لم تكن ممكنة في إعداد المفتاح المشترك السابق. ## فوائد استخدام مفتاح X API الخاص بك يوفر استخدام بيانات اعتماد X API الخاصة بك مزيدًا من التحكم والموثوقية مقارنةً بنموذج المفتاح المشترك السابق. يشمل ذلك: * **تجربة OAuth ذات علامة تجارية:** يرى المستخدمون اسم تطبيقك وعلامتك التجارية عند تفويض الوصول إلى X. * **حدود معدل مخصصة:** يخضع استخدامك لـ API لحدود حساب X Developer الخاص بك، بشكل منفصل عن مستخدمي Ayrshare الآخرين. يمكنك مراقبة استخدامك في [X Developer Console](https://console.x.com) ومراجعة [مستندات حدود معدل X API](https://developer.x.com/en/docs/x-api/rate-limits). * **التحكم في بيانات الاعتماد:** يبقى API Key وSecret الخاصان بك في حساب X Developer الخاص بك. لا يخزن Ayrshare مفاتيحك السرية. * **قابلية النقل:** لأن المستخدمين يُصادقون بتطبيق X الخاص بك، يبقى تكاملك تحت سيطرتك الكاملة. * **رؤية الاستخدام:** تعرض لوحة تحكم X Developer الخاصة بك طلبات API وحدود المعدل واستخدام الأرصدة. X هي أول منصة تتطلب هذا النموذج، لكن المزيد من المنصات تتحرك نحو "أحضر مفتاح API الخاص بك". نحن نُوسّع هذه الإمكانية عبر Ayrshare، لكي يحصل المطورون على نفس التحكم والاستقلالية عبر جميع المنصات الاجتماعية. ## الأمان * لا يتم تخزين API Key وAPI Secret من قبل Ayrshare. * للاطلاع على أفضل ممارسات الأمان العامة، راجع [دليل أمان المصادقة من X](https://docs.x.com/resources/fundamentals/authentication). ## الأسئلة الشائعة **لا.** تقوم بإعداد **تطبيق X Developer واحد** ضمن حساب X الخاص بك، ويُعاد استخدام نفس **API Key + API Secret** لكل ملف تعريف فرعي / مستخدم نهائي تربطه ضمن حساب Ayrshare الخاص بك. * تُنشئ تطبيق X Developer **مرة واحدة**. * تُمرِّر نفس الترويستين (`X-Twitter-OAuth1-Api-Key` و`X-Twitter-OAuth1-Api-Secret`) في كل استدعاء Ayrshare API، بغض النظر عن الملف الشخصي الفرعي المقصود. * لا يزال يتعين على المستخدمين النهائيين لديك المرور بتدفق ربط OAuth لتفويض حساب X الخاص بهم، لكنهم **لا** يحتاجون إلى تطبيق X Developer أو مفاتيح API الخاصة بهم. يتصلون عبر تطبيقك. * تشترك جميع الملفات الفرعية في نفس حساب X Developer، ونفس حدود المعدل، ونفس رصيد الأرصدة. الوقت الوحيد الذي تتعامل فيه مع المفاتيح لكل ملف تعريف هو في جسم [generateJWT](/apis/profiles/generate-jwt) أثناء الترحيل، وهي لا تزال نفس المفتاحين، فقط يتم توصيلهما إلى صفحة الربط بحيث يمكن للمستخدمين النهائيين إعادة التفويض ضمن تطبيقك. نعم. اعتبارًا من 31 مارس 2026، تتطلب جميع عمليات X عبر Ayrshare بيانات اعتماد X API الخاصة بك. إذا لم تُعدّ حساب X Developer الخاص بك بعد، فاتبع الخطوات أعلاه. يتطلب النشر على X عبر Ayrshare بيانات اعتماد X API الخاصة بك. يتم رفض الطلبات دون بيانات اعتماد BYO صالحة. لا يتأثر النشر على المنصات الأخرى (Instagram وLinkedIn وFacebook وTikTok، إلخ). تفرض X رسومًا لكل استدعاء API. إنشاء منشور يكلف حوالي \$0.01، وقراءة منشور تكلف حوالي \$0.005. على سبيل المثال، نشر 100 منشور شهريًا سيكلف حوالي \$1. راجع [صفحة أسعار X](https://docs.x.com/x-api/fundamentals/pricing) للتفاصيل الكاملة. لا. سعر اشتراك Ayrshare الخاص بك يبقى كما هو. التكلفة الإضافية الوحيدة هي رسوم استخدام X API التي تُفوترها X مباشرةً عبر حساب المطور الخاص بك. لا. لا يُخزّن Ayrshare API Key وAPI Secret الخاصين بك. للاطلاع على أفضل ممارسات الأمان العامة، راجع [دليل أمان المصادقة من X](https://docs.x.com/resources/fundamentals/authentication). نعم. يمكنك استخدام تطبيق X الحالي طالما أن لديه أذونات "Read and write" مُفعَّلة (وDirect Messages إذا كنت تستخدم ميزات الرسائل المباشرة). ستحتاج إلى API Key (Consumer Key) وAPI Secret (Consumer Secret) من قسم Keys and tokens في X Developer Console. اربط حساب X الخاص بك عبر OAuth، ثم ضمّن هاتين الترويستين في طلبات Ayrshare API. إذا غيّرت أذونات تطبيقك منذ الإعداد الأولي، أعِد ربط حساب X الخاص بك بحيث يرث Access Token الأذونات المُحدَّثة. تحتاج إلى API Key (Consumer Key) وAPI Secret (Consumer Secret). راجع [جدول مرجع الترويسات](#header-reference) أعلاه لمعرفة أي ترويسة Ayrshare يتم ربطها بكل منهما. يمكنك تجاهل Client ID وClient Secret وBearer Token وAccess Token وAccess Token Secret. هما بيانات اعتماد مختلفة تمامًا لطرق مصادقة مختلفة: * **API Key** (يُسمى أيضًا "Consumer Key") لـ OAuth 1.0a. API Key (Consumer Key) + API Secret هو ما يستخدمه Ayrshare. يعمل مع جميع ميزات X، والرموز لا تنتهي أبدًا، ولا حاجة إلى منطق تجديد. * **Client ID** لـ OAuth 2.0. أنت لا تحتاج إليه لـ Ayrshare. تنتهي رموز OAuth 2.0 بعد فترة قصيرة وتتطلب إدارة رمز تجديد. لـ Ayrshare، تحتاج فقط إلى API Key وAPI Secret. يمكنك تجاهل Client ID وClient Secret وBearer Token. تنتهي رموز الوصول لـ OAuth 2.0 كل ساعتين ورموز تجديد X تُستخدم مرة واحدة (كل تجديد يُبطِل الرمز القديم). هذا يجعل من المستحيل دعم نموذج BYO عديم الحالة، خاصةً للمنشورات المجدولة. لا تنتهي رموز OAuth 1.0a أبدًا، وتعمل مع جميع ميزات X، ولا تتطلب أي إدارة للرموز. نعم. إذا ربط مستخدموك X عبر Ayrshare قبل إعدادك لمفاتيح BYO، فسيحتاجون إلى إعادة الاتصال. رموز الوصول الحالية صدرت ضمن تطبيق X الخاص بـ Ayrshare ولن تعمل مع مفاتيحك الاستهلاكية. راجع [ترحيل الملفات الشخصية الموجودة](#migrating-existing-profiles-business--enterprise) أعلاه للاطلاع على العملية خطوة بخطوة. لا. يؤثر هذا التغيير فقط على النشر إلى X. جميع تكاملات المنصات الأخرى في Ayrshare تستمر في العمل كالمعتاد. لم يعد النشر التلقائي عبر RSS إلى X مدعومًا. تعمل خلاصات RSS تلقائيًا وفقًا لجدول زمني، لكن نموذج أحضر مفتاح API الخاص بك يتطلب توفير بيانات الاعتماد مع كل طلب API. لهذا السبب، لا يمكن لخلاصات RSS المصادقة عند إرسال المنشور. إذا كنت تستخدم RSS سابقًا للنشر إلى X، فإننا نوصي بالتبديل إلى [المنشورات المجدولة](/apis/post/overview#schedule-posts) أو استدعاءات API المباشرة التي تتضمن بيانات اعتمادك. النشر التلقائي عبر RSS إلى جميع المنصات الأخرى دون تغيير. يعني هذا أن حساب X Developer الخاص بك لا يحتوي على أرصدة API متاحة. انتقل إلى [console.x.com](https://console.x.com) ← **Billing → Credits** واشترِ الأرصدة. حتى \$5 كافٍ لمئات من استدعاءات API. بمجرد تحميل الأرصدة، أعِد محاولة طلبك. Access Token الخاص بك لا يحتوي على الأذونات الصحيحة. يعني هذا عادةً واحدًا من أمرين: 1. **أذونات تطبيقك مُعيَّنة على "Read" بدلاً من "Read and write".** انتقل إلى Settings الخاص بتطبيقك في Developer Console وغيّره إلى **Read and write and Direct message**. 2. **غيّرت الأذونات بعد ربط حساب X الخاص بك.** تحتفظ Access Tokens بالأذونات التي أُنشئت بها. أعِد ربط حساب X الخاص بك عبر OAuth بحيث يرث الرمز الجديد الأذونات المُحدَّثة. فريق الدعم لدينا سعيد بالمساعدة. إذا كانت لديك أي أسئلة أو واجهت مشكلات أثناء الإعداد، يرجى التواصل عبر [support@ayrshare.com](mailto:support@ayrshare.com)، وسنُرشدك خلال العملية. ## استكشاف الأخطاء وإصلاحها تأكد من أنك ترسل كلتا الترويستين المطلوبتين: * `X-Twitter-OAuth1-Api-Key` * `X-Twitter-OAuth1-Api-Secret` إذا رأيت خطأ عدم تطابق الزوج (على سبيل المثال، "You provided Api-Key but not Api-Secret")، فهذا يعني أن أحدهما مفقود. كلاهما مطلوبان دائمًا. ستُخبرك رسالة الخطأ بالترويسة المفقودة تحديدًا. إذا رأيت هذا الخطأ عند محاولة ربط حساب X الخاص بك، تأكد من إضافة عناوين URL الاستدعاء المطلوبة إلى إعدادات تطبيق X Developer الخاص بك (ضمن Authentication settings > Callback URI / Redirect URL): * `https://profile.ayrshare.com/social-accounts` * `https://app.ayrshare.com/social-accounts` راجع [خطوة إعداد Callback URL](#step-3-configure-app-permissions) أعلاه. حساب X Developer الخاص بك لا يحتوي على أرصدة API مُحمَّلة. انتقل إلى [console.x.com](https://console.x.com) ← **Billing → Credits** واشترِ الأرصدة. حتى \$5 كافٍ لمئات من استدعاءات API. Access Token الخاص بك لا يحتوي على الأذونات الصحيحة. يعني هذا عادةً: 1. **أذونات تطبيقك مُعيَّنة على "Read" بدلاً من "Read and write".** انتقل إلى Settings الخاص بتطبيقك في Developer Console وغيّره إلى **Read and write and Direct message**. 2. **غيّرت الأذونات بعد ربط حساب X الخاص بك.** تحتفظ Access Tokens بالأذونات التي أُنشئت بها. أعِد ربط حساب X الخاص بك عبر OAuth بحيث يرث الرمز الجديد الأذونات المُحدَّثة. ## تحتاج إلى مساعدة؟ إذا كانت لديك أي أسئلة أو واجهت مشكلات أثناء إعداد مفتاح X API الخاص بك، فإن فريقنا الهندسي سعيد بالمساعدة. يمكنك التواصل معنا في أي وقت على [support@ayrshare.com](mailto:support@ayrshare.com).