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

# TikTok API

> خيارات النشر باستخدام TikTok API

<Info>
  تقدّم Ayrshare [نشرًا مباشرًا لفيديوهات TikTok](https://www.ayrshare.com/blog/introducing-tiktok-direct-publishing-analytics-and-commenting/) وإدارة للتعليقات واسترجاعًا للتحليلات المتقدّمة لأيٍّ من حسابك الشخصي أو التجاري على TikTok باستخدام TikTok API.

  يعالج TikTok الفيديو والصور بشكل غير متزامن، لذا ستكون استجابة JSON بحالة status: "pending" لكلٍّ من المنشورات الفورية والمجدولة. بمجرد أن ينتهي TikTok من المعالجة، سيتمّ استدعاء [Scheduled Action webhook](/apis/webhooks/actions#scheduled-action) المسجّل لديك.
</Info>

## منشور فيديو TikTok

JSON لمنشور فيديو TikTok أساسي يُنشر مباشرة:

```json TikTok Video Post theme={"system"}
{
  "post": "The best TikTok \n video ever #bestvideo", // Max 2,200 characters with a line break
  "mediaUrls": ["https://img.ayrshare.com/012/tiktok.mp4"],
  "platforms": ["tiktok"]
}
```

مثال على استجابة JSON للمنشور:

```json TikTok Video Post Response theme={"system"}
{
  "status": "success",
  "errors": [],
  "postIds": [
    {
      "status": "success",
      "idShare": "video.7088122496758679353.nzLqBWbf",
      "id": "pending",
      "isVideo": true,
      "platform": "tiktok"
    }
  ],
  "id": "lb42orDhySAZmLWtj6b6",
  "refId": "23a9da9e0df1184a7a6a1fc2c60b8023aa9a32a1",
  "post": "The best TikTok video ever #bestvideo"
}
```

<ul class="custom-bullets">
  <li>
    لا يدعم TikTok حاليًا فواصل الأسطر في نص المنشور. سيتم تجاهل فواصل الأسطر
    المضمّنة.
  </li>

  <li>
    يمكن نشر فيديو واحد أو ما يصل إلى 35 صورة. لا يدعم TikTok مزيجًا من
    الفيديو والصور. يُرجى الاطلاع أدناه لمزيد من التفاصيل.
  </li>

  <li>
    إذا لم ينتهِ الفيديو بامتداد معروف، فاستخدم
    [isVideo](/apis/post/overview#video-extension).
  </li>

  <li>
    يدعم TikTok أيضًا إرسال الوسائط دون نص المنشور. إذا كنت لا ترغب في تضمين نص المنشور
    أرسل سلسلة فارغة `post: ""`.
  </li>

  <li>
    راجع [إرشادات وسائط TikTok](/media-guidelines/tiktok) و[تفويض
    TikTok](/dashboard/connect-social-accounts/tiktok) لمزيد من المعلومات.
  </li>
</ul>

### متطلبات فيديو TikTok

<ul class="custom-bullets">
  <li>يُرجى الاطلاع على [متطلبات فيديو TikTok](/media-guidelines/tiktok#video).</li>

  <li>
    يجب أن ينتهي الفيديو بامتداد فيديو معروف مثل mp4. يُرجى إمّا عكس وكيل عنوان URL أو
    إضافة [عنوان URL جميل مع
    CDN](https://www.ayrshare.com/blog/how-to-put-a-cdn-in-front-of-firebase-cloud-storage/) أو استخدام
    نقطة النهاية [/media](/apis/media/overview).
  </li>

  <li>حدّ أحرف نص منشور TikTok هو 2,200.</li>
</ul>

<Note>
  يحدّ TikTok من نشر فيديو API إلى 6 فيديوهات في الدقيقة بحدّ أقصى 15 فيديو في
  اليوم.
</Note>

## منشور صورة TikTok

JSON لمنشور صورة (صورة فوتوغرافية) TikTok أساسي يُنشر مباشرة:

```json TikTok Image Post theme={"system"}
{
  "post": "The best TikTok \n video ever #bestvideo", // Max 2,200 characters with a line break
  "mediaUrls": [
    "https://img.ayrshare.com/012/gb.jpg",
    "https://img.ayrshare.com/random/photo-1.jpg"
  ], // Up to 35 images
  "platforms": ["tiktok"]
}
```

مثال على استجابة JSON:

```json TikTok Image Post Response theme={"system"}
{
  "status": "success",
  "errors": [],
  "postIds": [
    {
      "status": "success",
      "idShare": "p_pub_url~v2.7408974036430047275",
      "id": "pending",
      "isVideo": false,
      "platform": "tiktok"
    }
  ],
  "id": "8815mJ5bWApEebWjE233",
  "tikTokId": "p_pub_url~v2.7408974036430047333",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc333",
  "post": "Opportunity is missed by most people because it is dressed in overalls and looks like work - Thomas Edison"
}
```

<ul class="custom-bullets">
  <li>
    لا يدعم TikTok حاليًا فواصل الأسطر في نص المنشور. سيتم تجاهل فواصل الأسطر
    المضمّنة.
  </li>

  <li>يمكن نشر فيديو واحد أو ما يصل إلى 35 صورة.</li>

  <li>
    لا يدعم TikTok مزيجًا من الفيديو والصور. يُرجى الاطلاع أدناه لمزيد من التفاصيل.
  </li>

  <li>يجب أن تكون الصور من نوع JPG أو JPEG أو WEBP. لا يقبل TikTok ملفات وسائط PNG.</li>

  <li>
    يمكنك أيضًا تحديد إحدى الصور كصورة غلاف باستخدام `imageCoverIndex`. افتراضيًا،
    يتم استخدام الصورة الأولى. يُرجى الاطلاع أدناه للتفاصيل.
  </li>
</ul>

### متطلبات صور TikTok

<ul class="custom-bullets">
  <li>يُرجى الاطلاع على [متطلبات صور TikTok](/media-guidelines/tiktok#images).</li>
  <li>يمكن تضمين ما يصل إلى 35 صورة في منشور، بحجم 20 ميجابايت لكل صورة.</li>
  <li>يجب أن تكون الصور من نوع JPG أو JPEG أو WEBP. لا يقبل TikTok ملفات وسائط PNG.</li>
  <li>حدّ أحرف نص منشور TikTok هو 2,200.</li>
</ul>

<Note>
  يحدّ TikTok من نشر فيديو API إلى 6 صور في الدقيقة بحدّ أقصى 15 صورة في
  اليوم.
</Note>

## معالجة TikTok

يقوم TikTok بمعالجة غير متزامنة للفيديوهات والصور، لذلك ستحتوي الاستجابة على حقل `id` مُعيَّن إلى `"pending"`.
بعد أن يكمل TikTok المعالجة، عادة خلال 1 - 2 دقيقة، سيتم تحديث حقل `id` بمعرّف فيديو TikTok `id` وسيتم إضافة `postUrl`.

<ul class="custom-bullets">
  <li>
    يمكنك استرداد الحالة النهائية لمنشور TikTok باستخدام
    [webhooks](/apis/webhooks/actions#tiktok-publishing-webhook) أو نقطة النهاية
    [/history](/apis/history/overview) وعادة ما يستغرق ذلك 1-2 دقيقة ليكون متاحًا.
  </li>

  <li>
    عندما ينشر المستخدم الفيديو في تطبيق TikTok للجوّال، سيتمّ إرسال webhook "مجدول"
    مع `subAction: "tikTokPublished"`.
  </li>

  <li>
    يتم تأجيل [التعليق الأول](/apis/post/overview#first-comment) على منشور TikTok: يتم نشره
    تلقائيًا بمجرد أن يحلّ webhook `tikTokPublished` `id` الفيديو الحقيقي، وليس عند
    وقت النشر. يجب أن تكون `visibility` الفيديو `public`، وإلا فلن يمكن نشر التعليق الأول ويتم إرجاع خطأ
    تعليق.
  </li>

  <li>
    في حالة حدوث خطأ، مثل عدم قدرة TikTok على معالجة الفيديو أو فشل اختبارات Ayrshare
    الداخلية، فسيتم تعيين حقل `id` إلى "failed" وسيحتوي حقل `errors` على تفاصيل
    الخطأ.
  </li>

  <li>يُستخدم `idShare` للإشارة الداخلية إلى الفيديو المعلَّق.</li>
</ul>

## خيارات TikTok

عند نشر فيديو أو صور TikTok، تتوفّر [خيارات إضافية](/apis/post/social-networks/tiktok#available-tiktok-options).

مثال على نشر فيديو:

```json TikTok Video Publishing theme={"system"}
{
  "tikTokOptions": {
    "disableComments": true, // Default false. Disable comments on the published video.
    "disableDuet": true, // Default false. Disable duets on the published video.
    "disableStitch": true // Default false. Disable stitches on the published video.
  }
}
```

مثال على نشر صورة:

```json TikTok Image Publishing theme={"system"}
{
  "tikTokOptions": {
    "imageCoverIndex": 1, // Use the second image in the mediaUrls.
    "title": "Amazing images"
  }
}
```

### الخيارات

الخيارات التالية متاحة لمنشورات TikTok.
يجب إضافتها إلى كائن `tikTokOptions`.
يُرجى الاطلاع أدناه لمزيد من التفاصيل حول كل خيار.

```json TikTok Options theme={"system"}
{
  "post": "The best TikTok video ever #bestvideo",
  "mediaUrls": ["https://img.ayrshare.com/012/tiktok.mp4"],
  "platforms": ["tiktok"],
  "tikTokOptions": {
    "autoAddMusic": true,
    "disableComments": true,
    "disableDuet": true,
    "disableStitch": true,
    "draft": true,
    "isAIGenerated": true,
    "isBrandedContent": true,
    "isBrandOrganic": true,
    "imageCoverIndex": 1,
    "title": "Amazing images",
    "thumbNailOffset": 30000,
    "visibility": "public"
  }
}
```

<ParamField body="autoAddMusic" type="boolean" default={false}>
  ما إذا كانت الموسيقى الموصى بها ستتم إضافتها تلقائيًا إلى المنشور.
  إذا قمت بتعيين هذا الحقل إلى `true`، فيمكنك تغيير الموسيقى لاحقًا في تطبيق TikTok.

  نوع الوسائط: image
</ParamField>

<ParamField body="disableComments" type="boolean" default={false}>
  ما إذا كان سيتم تعطيل التعليقات على المنشور المنشور.

  نوع الوسائط: video, image
</ParamField>

<ParamField body="disableDuet" type="boolean" default={false}>
  تعطيل duets على الفيديو المنشور.

  نوع الوسائط: video
</ParamField>

<ParamField body="disableStitch" type="boolean" default={false}>
  تعطيل stitch على الفيديو المنشور.

  نوع الوسائط: video
</ParamField>

<ParamField body="draft" type="boolean" default={false}>
  ما إذا كنت ستنشئ منشور مسودة.

  راجع [خيارات المسودة](/apis/post/social-networks/tiktok#tiktok-video-draft-post) لمزيد من المعلومات.

  نوع الوسائط: video or image
</ParamField>

<ParamField body="isAIGenerated" type="boolean" default={false}>
  ما إذا كان سيتم تمكين تبديل المحتوى المولَّد بالذكاء الاصطناعي لمنشور الفيديو.

  إذا قمت بتمكين التبديل، فسيتم تصنيف الفيديو الخاص بك على أنه "Creator labeled as AI-generated" بمجرد نشره ولا يمكن تغييره.
  تشير علامة "Creator labeled as AI-generated" إلى أن المحتوى تم إنشاؤه بالكامل بواسطة الذكاء الاصطناعي أو تم تحريره بشكل كبير باستخدام الذكاء الاصطناعي.

  <Note>
    لن يؤثّر تشغيل إعداد المحتوى المولَّد بالذكاء الاصطناعي على توزيع الفيديو الخاص بك طالما
    أنه لا ينتهك [إرشادات مجتمع](https://www.tiktok.com/community-guidelines/en/) TikTok.
  </Note>

  نوع الوسائط: video
</ParamField>

<ParamField body="isBrandedContent" type="boolean" default={false}>
  ما إذا كان سيتم تمكين تبديل <a href="https://creatormarketplace.tiktok.com/help#/doc/9493/10008169">Branded Content</a>. إذا تم تعيين هذا الحقل إلى `true`، فسيتم تصنيف الفيديو على أنه Branded Content، مما يشير إلى أنك في شراكة مدفوعة مع علامة تجارية. سيتم إرفاق علامة "Paid partnership" بالفيديو.

  نوع الوسائط: video, image
</ParamField>

<ParamField body="isBrandOrganic" type="boolean" default={false}>
  ما إذا كان سيتم تمكين تبديل Brand Organic Content. إذا تم تعيين هذا الحقل إلى `true`، فسيتم تصنيف الفيديو على أنه Brand Organic Content، مما يشير إلى أنك تروّج لنفسك أو لأعمالك الخاصة. سيتم إرفاق علامة "Promotional content" بالفيديو.

  نوع الوسائط: video, image
</ParamField>

<ParamField body="imageCoverIndex" type="number" default="0">
  فهرس `mediaUrls` الذي سيتم استخدامه كغلاف للمنشور.

  نوع الوسائط: image
</ParamField>

<ParamField body="title" type="string">
  عنوان المنشور.

  نوع الوسائط: image
</ParamField>

<ParamField body="thumbNailOffset" type="number">
  الإطار الذي سيتم استخدامه لغلاف الفيديو.

  راجع [خيارات الصورة المصغّرة للفيديو](/apis/post/social-networks/tiktok#video-thumbnail) لمزيد من المعلومات.

  نوع الوسائط: video
</ParamField>

<ParamField body="visibility" type="string" default="public">
  كيف تتم مشاركة المنشور ومن يمكنه رؤيته.

  القيم: `public` أو `private` أو `followers` أو `friends`.

  راجع [خيارات الرؤية](/apis/post/social-networks/tiktok#visibility-options) لمزيد من المعلومات.

  نوع الوسائط: image
</ParamField>

### خيارات الرؤية

| الرؤية    | الوصف                          |
| :-------- | :----------------------------- |
| public    | مرئي لجميع مستخدمي TikTok.     |
| private   | خاص، مرئي فقط للحساب نفسه.     |
| followers | مرئي فقط لمتابعي الحساب.       |
| friends   | مرئي فقط للمتابعين المتبادلين. |

ستظل المنشورات الخاصة في حالة `pending` ولن يتم إرسال webhook من TikTok حتى يتمّ نشر المنشور علنيًا.

## الصورة المصغّرة للفيديو

هناك طريقتان لتعيين صورة مصغّرة، تُعرف أيضًا بصورة الغلاف، لفيديو TikTok:

1. استخدام معلمة `thumbNailOffset` لتعيين إطار الصورة المصغّرة.
2. استخدام معلمة `thumbNail` لتعيين صورة مصغّرة من عنوان URL.

يتم دعم الفيديوهات فقط لتعيين صورة مصغّرة.

### إزاحة الصورة المصغّرة

عيّن صورة مصغّرة لفيديو TikTok باختيار إطار إزاحة.

```json TikTok Video Thumbnail Offset theme={"system"}
{
  "tikTokOptions": {
    "thumbNailOffset": 30000 // milliseconds of offset image
  }
}
```

الإزاحة هي الموقع بالمللي ثانية لإطار الصورة المصغّرة. القيمة الافتراضية هي `0`، وهي الإطار الأول من الفيديو.

### عنوان URL للصورة المصغّرة

عيّن صورة مصغّرة لفيديو TikTok برفع صورة من عنوان URL.

```json TikTok Video Thumbnail URL theme={"system"}
{
  "tikTokOptions": {
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg"
  }
}
```

إذا استخدمت معلمة `thumbNail`، فسيتم تجاهل معلمة `thumbNailOffset`.

يُرجى الاطلاع على [متطلبات صورة TikTok المصغّرة](/media-guidelines/tiktok#video-thumbnail) لمزيد من المعلومات.

## إشارات TikTok

اذكر مقبض TikTok آخر بإضافة `@handle` في نص المنشور. على سبيل المثال:

```json TikTok Mention theme={"system"}
{
  "post": "Love the @ayrshare social media api"
}
```

<Warning>
  يُرجى مراجعة [القواعد المهمّة](/testing/post-verification#mentions) بشأن الإشارات.
</Warning>

## منشور مسودة TikTok

أنشئ منشور مسودة لفيديو أو صورة TikTok، ما يتيح لك تحرير الفيديو أو الصورة قبل النشر.

```json TikTok Video Draft Post theme={"system"}
{
  "post": "The best TikTok video ever #bestvideo", // empty string is allowed
  "mediaUrls": ["https://img.ayrshare.com/012/tiktok.mp4"],
  "platforms": ["tiktok"],
  "tikTokOptions": {
    "draft": true
  }
}
```

سيتم العثور على منشور مسودة الفيديو أو الصورة ضمن **صندوق الوارد** في الإشعارات في الصف السفلي من تطبيق TikTok.
ابحث عن رسالة **إشعارات النظام** ثم انقر على أعلى رسالة **Your content from Ayrshare is ready**.

سيظل `postUrl` الخاص بـ Ayrshare في حالة `pending` حتى يتم نشر الفيديو. التعليق الأول غير مدعوم في منشورات المسودة.

<img src="https://mintcdn.com/ayrshare-docs/Nmrhj2Gh7WSf62Bh/images/apis/post/tiktok-draft-post.webp?fit=max&auto=format&n=Nmrhj2Gh7WSf62Bh&q=85&s=6e7fdce5ef106f6af6cd060bfbc446ba" alt="TikTok Draft Post" class="center" width="278" height="600" data-path="images/apis/post/tiktok-draft-post.webp" />

## تحديث التفويض

يجب إعادة تفويض TikTok *كل عام* عبر صفحة الحسابات الاجتماعية.

<ul class="custom-bullets">
  <li>
    سيتم إرسال إشعار عبر البريد الإلكتروني وwebhook social action قبل 15 يومًا من انتهاء صلاحية
    التفويض.
  </li>

  <li>
    يمكن استرداد تاريخ التحديث المطلوب والأيام المتبقّية من نقطة النهاية
    [/user](/apis/user/overview).
  </li>
</ul>

## حدود الأحرف

يُرجى الاطلاع على [حدود أحرف TikTok](/help-center/technical-support/character_limits#tiktok-character-limits) لمزيد من المعلومات.

## معلومات إضافية

[أمثلة إضافية على استخدام TikTok API](https://www.ayrshare.com/blog/tiktok-api-how-to-post-to-tiktok-using-a-social-media-api/).