> ## 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.

# Node.js NPM

> ادمج Ayrshare API في تطبيق Node الخاص بك عبر حزمة Social API NPM

## نظرة عامة

تتيح لك [حزمة Social API NPM](https://www.npmjs.com/package/social-media-api) من Ayrshare دمج Ayrshare API في تطبيق Node.js الخاص بك.

### التثبيت

ثبّت حزمة Social API NPM إذا كنت تستخدم Node على جانب الخادم.
تُبسّط الحزمة الاستدعاءات عن طريق تغليف استدعاءات RESTful.

```bash theme={"system"}
npm i social-media-api
```

<Info>احصل على مفتاح API السرّي الخاص بك من [لوحة تحكم Ayrshare](https://app.ayrshare.com/).</Info>

### الاستخدام العام

أمثلة على Post وHistory وDelete:

<Info>
  **هل تنشر على X/Twitter؟** اعتبارًا من 31 مارس 2026، تتطلب عمليات X/Twitter عبر Ayrshare بيانات اعتماد تطبيق X Developer الخاصة بك — تفرض Ayrshare ذلك على كل استدعاء موجّه إلى X. أضف رأسي BYO إلى طلبك. راجع [دليل الإعداد](/dashboard/connect-social-accounts/x-twitter-byo-keys) للتفاصيل.
</Info>

اعتبارًا من الإصدار v1.3.0 تتضمن SDK مساعد `setTwitterByo(apiKey, apiSecret)` الذي يُرفق رأسي `X-Twitter-OAuth1-*` المطلوبَين بكل طلب لاحق:

```javascript theme={"system"}
const SocialPost = require("social-media-api");
const social = new SocialPost(API_KEY)
  .setTwitterByo(MY_X_API_KEY, MY_X_API_SECRET);

await social.post({
  post: "Hello from BYO",
  platforms: ["twitter"]
});
```

استخدم `clearTwitterByo()` لإزالة الرؤوس — مفيد عند إعادة استخدام مثيل SDK واحد عبر عدة مستأجرين (tenants):

```javascript theme={"system"}
social.clearTwitterByo().setTwitterByo(nextTenant.key, nextTenant.secret);
```

```javascript theme={"system"}
const SocialPost = require("social-media-api");
const API_KEY = "API KEY"; // get an API Key at ayrshare.com
const social = new SocialPost(API_KEY);

const run = async () => {
  /** post */
  const post = await social
    .post({
      post: "One more time",
      platforms: ["twitter", "facebook", "linkedin"],
      profileKey: "DJKJDK-SKDJKDJF" // used with a User Profile
    })
    .catch(console.error);
  console.log(post);

  /** history */
  const history = await social.history().catch(console.error);
  console.log(history);

  /** delete */
  const deletePost = await social.delete({ id: post.id }).catch(console.error);
  console.log(deletePost);
};

run();
```

### نظرة عامة بالفيديو على حزمة Social Media API NPM

<div class="video-container">
  <iframe width="560" height="315" src="https://www.youtube.com/embed/OMtj2h6sW6U" title="Social Media API NPM Package" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen />
</div>

النشر إلى وسائل التواصل الاجتماعي عبر API

### Profile Key

يمكنك تحديد Profile Key لـ User Profile في نص طلب POST أو في استعلام GET عبر الحقل `profileKey`.

### تجربة Social API

للاطلاع على مثال تكامل Node.js (باستخدام استدعاءات RESTful API)، راجع مستودع GitHub:

<Card title="كود تجربة Social API" icon="github" href="https://github.com/ayrshare/social-api-demo" horizontal>
  Social API Demo هو تطبيق ويب يتيح للمستخدمين تأليف المحتوى وجدولته ونشره
  على منصات وسائل تواصل اجتماعي متعددة في الوقت نفسه.
</Card>

### مزيد من المعلومات والوثائق

<ul class="custom-bullets">
  <li>[NPM Package](https://www.npmjs.com/package/social-media-api)</li>
  <li>[Github Repository](https://github.com/ayrshare/social-media-api)</li>
  <li>[Issue Discussion](https://github.com/ayrshare/social-media-api/issues)</li>
</ul>