واجهة API خارجية للمستخدمين

واجهة Tareno API للمسودات والجدولة ورفع الوسائط والاستخدام والتحليلات

يغطي هذا المرجع نقاط النهاية العامة التي يمكن للمستخدمين الفعليين استدعاؤها بمفتاح API. وتُستثنى عمداً نقاط النهاية الداخلية أو المخصصة للمشرفين، مثل مسارات إدارة المدونة.

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

https://tareno.co/api/external

أفضل استخدام مع

Claude وChatGPT وCursor وGemini وPerplexity والأتمتة على نمط Zapier والبرامج النصية والأدوات الداخلية ومسارات التصيير والتطبيقات المخصصة.

فتح دليل مفتاح API دليل n8n دليل Make

تكامل الذكاء الاصطناعي

تحكّم في Tareno من Codex أو Claude Code أو Cursor

استخدم MCP البعيد لإدارة وسائل التواصل الاجتماعي عبر أدوات منظمة. تتطلب التغييرات المؤثرة في النشر موافقة داخل لوحة تحكم Tareno بعد تسجيل الدخول.

دليل إعداد MCP دليل n8n دليل Make

Claude Code

Codex

Cursor

المصادقة

رؤوس مفاتيح API والنطاقات

يمكنك المصادقة باستخدام رمز Bearer أو الرأس X-Tareno-API-Key. تتطلب نقاط النهاية للقراءة فقط، مثل الحسابات والاستخدام واللوحات والتحليلات، نطاق read. ويتطلب رفع الوسائط وإنشاء المنشورات نطاق publish.

Headers

Authorization: Bearer tk_live_your_key
X-Tareno-API-Key: tk_live_your_key

تُدار مفاتيح API من: لوحة التحكم ← الإعدادات ← مفاتيح API.

JavaScript example

const response = await fetch(
  "https://tareno.co/api/external/analytics/overview?period=month",
  { headers: { Authorization: "Bearer tk_live_your_key" } }
)
const data = await response.json()

بدء سريع

مسار الأتمتة المعتاد

تتبع معظم مسارات العمل الخطوات الأربع نفسها: تحديد الحسابات، ورفع الوسائط أو الإشارة إليها، وإنشاء مسودات أو جداول، ثم مراجعة التحليلات أو الاستخدام.

GET/accounts

1. تحديد معرّفات الحسابات

اجلب الحسابات المتصلة أولاً كي يستهدف مسار العمل القناة أو الصفحة الصحيحة دائماً.

الطلب

curl -X GET "https://tareno.co/api/external/accounts" \
  -H "Authorization: Bearer tk_live_your_key"

POST/media

2. رفع الوسائط أو استيرادها

ارفع الملفات المصيّرة إلى مكتبة الوسائط لتتمكن من إعادة استخدام الأصل نفسه في المسودات والمنشورات المجدولة والحملات القادمة.

الطلب

curl -X POST "https://tareno.co/api/external/media" \
  -H "Authorization: Bearer tk_live_your_key" \
  -F "file=@video.mp4"

POST/publish

3. حفظ مسودة أو جدولة منشور

استخدم وضع draft عندما تريد مسار مراجعة آمن، أو وضع schedule عندما تعرف الحساب والوقت مسبقاً.

الطلب

curl -X POST "https://tareno.co/api/external/publish" \
  -H "Authorization: Bearer tk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"mode":"draft","platform":"instagram","text":"Caption"}'

GET/analytics/overview

4. استرجاع التحليلات إلى مسار العمل

اجلب تحليلات عامة أو خاصة بالمنصة لإعداد تقارير الأداء أو ملء لوحات التحكم أو تشغيل الإجراءات اللاحقة.

الطلب

curl -X GET "https://tareno.co/api/external/analytics/overview?period=month" \
  -H "Authorization: Bearer tk_live_your_key"

نقاط النهاية

مرجع نقاط النهاية الموجهة للمستخدم

هذه هي نقاط النهاية العامة المتاحة حالياً للمستخدمين عبر External API. كل ما يرد هنا متوافق مع مفاتيح API وآمن للتوثيق العلني.

GET/me

المصادقة وفحص الاتصال

يعيد هوية Tareno والخطة السارية ونطاقات مفتاح API وحدود Automation API. يستخدم Zapier هذه النقطة للتحقق من الاتصال وتسميته ببريد الحساب الإلكتروني.

يتطلب نطاق read

الطلب

curl -X GET "https://tareno.co/api/external/me" \
  -H "Authorization: Bearer tk_live_your_key"

الاستجابة

{
  "id": "user_123",
  "email": "automation@example.com",
  "plan": "pro",
  "scopes": ["read", "publish"],
  "apiUsage": { "limit": 2000, "remaining": 2000 }
}

GET/posts?limit=3&accountId=acc_123&platform=instagram

عرض المنشورات المنشورة بعد تنقيحها

يعيد بيانات نموذجية متعلقة بالنشر لإعداد مشغل REST Hook. وتعكس فلاتر الحساب والمنصة الاختيارية فلاتر مشغل Post Published.

يتطلب نطاق readلا يتضمن أبداً رموزاً أو بيانات وصفية داخلية

الطلب

curl -X GET "https://tareno.co/api/external/posts?limit=3" \
  -H "Authorization: Bearer tk_live_your_key"

الاستجابة

{
  "posts": [{
    "id": "post_123",
    "title": "Spring promo",
    "text": "Published caption",
    "status": "published",
    "platform": "instagram",
    "accountId": "acc_123",
    "publishedAt": "2026-07-09T10:00:00.000Z"
  }]
}

GET/accounts

الحسابات المتصلة

يعرض الحسابات الاجتماعية المتصلة التابعة لمالك مفتاح API. استخدم معرّفات الحسابات هذه للمنشورات المجدولة والمباشرة والبحث عن لوحات Pinterest والتحليلات الخاصة بالحساب.

يتطلب نطاق read

الطلب

curl -X GET "https://tareno.co/api/external/accounts" \
  -H "Authorization: Bearer tk_live_your_key"

الاستجابة

{
  "accounts": [{
    "id": "acc_123",
    "platform": "instagram",
    "username": "yourhandle",
    "displayName": "Your Brand",
    "profilePicture": "https://..."
  }],
  "count": 1
}

POST/zapier/subscriptions

الاشتراك في Zapier REST Hook

يسجل مشغل Post Published فوري. يجب أن يكون targetUrl بعنوان HTTPS على hooks.zapier.com ويُخزن مشفراً. accountId وplatform فلاتر اختيارية.

يتطلب نطاق readلـ Zapier REST Hooks فقط

الطلب

curl -X POST "https://tareno.co/api/external/zapier/subscriptions" \
  -H "Authorization: Bearer tk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"targetUrl":"https://hooks.zapier.com/hooks/standard/123/abc","accountId":"acc_123","platform":"instagram"}'

الاستجابة

{
  "id": "sub_123",
  "event": "post.published",
  "active": true
}

DELETE/zapier/subscriptions/{id}

إلغاء الاشتراك في Zapier REST Hook

يعطّل اشتراكاً يملكه مفتاح API المصادَق عليه. يستدعي Zapier نقطة النهاية هذه كلما عُطّل المشغل أو أزيل Zap.

يتطلب نطاق readيتم التحقق من الملكية

الطلب

curl -X DELETE "https://tareno.co/api/external/zapier/subscriptions/sub_123" \
  -H "Authorization: Bearer tk_live_your_key"

الاستجابة

{
  "success": true
}

POST/publish

إنشاء مسودات أو جداول أو منشورات فورية

نقطة النهاية الرئيسية للنشر الموجه للمستخدم. استخدم mode=draft للإعداد الآمن وmode=schedule للنشر المجدول وmode=publish للنشر الفوري.

يتطلب نطاق publishيدعم النص والصورة والفيديو والدوّارقد يعيد TikTok Photo Mode الحالة processing قبل النشر النهائي

الطلب

curl -X POST "https://tareno.co/api/external/publish" \
  -H "Authorization: Bearer tk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "schedule",
    "accountId": "acc_instagram_123",
    "title": "Spring promo",
    "text": "Caption from your automation",
    "mediaUrls": ["https://pub.example.com/video.mp4"],
    "scheduledAt": "2026-04-20T09:00:00",
    "timezone": "Europe/Berlin"
  }'

الاستجابة

{
  "success": true,
  "postId": "post_123",
  "status": "scheduled",
  "scheduledAt": "2026-04-20T07:00:00.000Z"
}

// Immediate TikTok Photo Mode may return:
{
  "success": true,
  "postId": "post_123",
  "publishId": "v_pub_123",
  "status": "processing"
}

POST/media

رفع الوسائط إلى مكتبة الوسائط

يرفع ملفاً مباشرة أو يستورد ملفاً من عنوان URL. ويمكن بعد ذلك إعادة استخدام الأصل المرفوع عبر المسودات والجداول ومسارات النشر المباشر.

يتطلب نطاق publishرفع متعدد الأجزاء أو استيراد JSON

الطلب

curl -X POST "https://tareno.co/api/external/media" \
  -H "Authorization: Bearer tk_live_your_key" \
  -F "file=@promo-video.mp4"

الاستجابة

{
  "success": true,
  "mediaId": "asset_123",
  "url": "https://pub.example.com/promo-video.mp4"
}

GET/media

عرض الوسائط المرفوعة

يعيد عناصر الوسائط من مكتبة وسائط المستخدم. يفيد عندما يريد مسار العمل إعادة استخدام أصول موجودة بدلاً من رفع ملف جديد كل مرة.

يتطلب نطاق read

الطلب

curl -X GET "https://tareno.co/api/external/media" \
  -H "X-Tareno-API-Key: tk_live_your_key"

الاستجابة

{
  "media": [{
    "id": "asset_123",
    "name": "promo-video.mp4",
    "url": "https://pub.example.com/promo-video.mp4"
  }]
}

POST/media/sign

الحصول على عنوان رفع موقّع مسبقاً

ينشئ عنوان رفع مباشر إلى R2 ويدعم إزالة التكرار عبر contentHash. هذا هو المسار الموصى به لخطوط الوسائط الكبيرة والمصيّرات الخارجية.

يتطلب نطاق publishيدعم إزالة التكرار عبر تجزئة المحتوى

الطلب

curl -X POST "https://tareno.co/api/external/media/sign" \
  -H "Authorization: Bearer tk_live_your_key" \
  -d '{"fileName":"promo-video.mp4","contentType":"video/mp4"}'

الاستجابة

{
  "success": true,
  "signedUrl": "https://...",
  "expiresIn": 3600
}

POST/media/register-hash

تسجيل تجزئة المحتوى المرفوع

يُنهي مسار إزالة التكرار بعد رفع موقّع مسبقاً ناجح. استدعه بعد تخزين الملف كي يمكن إعادة استخدام الرفعات المستقبلية ذات التجزئة نفسها.

يتطلب نطاق publish

الطلب

curl -X POST "https://tareno.co/api/external/media/register-hash" \
  -H "Authorization: Bearer tk_live_your_key" \
  -d '{"contentHash":"sha256-abc123","publicUrl":"https://..."}'

الاستجابة

{
  "success": true,
  "registered": true
}

GET/pinterest/boards?accountId=acc_pinterest_123

جلب لوحات Pinterest

يعيد لوحات Pinterest المتاحة للحساب المتصل كي تتمكن الأتمتة من تعيين معرّف اللوحة الصحيح قبل الجدولة أو النشر.

يتطلب نطاق readPinterest فقط

الطلب

curl -X GET "https://tareno.co/api/external/pinterest/boards?accountId=acc_pinterest_123" \
  -H "Authorization: Bearer tk_live_your_key"

الاستجابة

{
  "boards": [{
    "name": "Marketing ideas",
    "value": "987654321"
  }]
}

GET/usage?period=month

فحص استخدام API

يعيد استهلاك API الحالي والتفصيل حسب نقطة النهاية والنشاط الأخير وتاريخ إعادة الضبط لفترة الفوترة الحالية.

يتطلب نطاق read

الطلب

curl -X GET "https://tareno.co/api/external/usage?period=month" \
  -H "Authorization: Bearer tk_live_your_key"

الاستجابة

{
  "usage": {
    "current": 187,
    "limit": 2000,
    "remaining": 1813,
    "percentUsed": 9
  }
}

واجهة API للتحليلات

قراءة التحليلات عبر API

نقاط نهاية التحليلات متاحة الآن عبر External API نفسه. وهي تحاكي بنية بيانات لوحة التحكم قدر الإمكان، لذا يمكنك استخدامها في التقارير والأتمتة ولوحات التحكم المخصصة.

تتطلب نقاط نهاية التحليلات خطة Starter أو أعلى ومفتاح API بنطاق read . وبدون وصول مدفوع للتحليلات، تعيد API: ANALYTICS_PLAN_REQUIRED.

InstagramFacebookTikTokYouTubeThreadsPinterestX / TwitterLinkedIn

GET/analytics/overview?period=month

نظرة عامة على التحليلات عبر المنصات

يجمع الجمهور ومرات الظهور والتفاعل وحجم المنشورات والتفصيل حسب المنصة وأفضل المنشورات عبر جميع الحسابات الاجتماعية المتصلة باستخدام بيانات مخزنة مؤقتاً ومتوافقة مع لوحة التحكم.

يتطلب نطاق readخطة Starter أو أعلى

الطلب

curl -X GET "https://tareno.co/api/external/analytics/overview?period=month" \
  -H "Authorization: Bearer tk_live_your_key"

الاستجابة

{
  "totalMetrics": {
    "audience": { "value": "12.4K", "change": "+5.2%" },
    "impressions": { "value": "84.1K", "change": "+12%" }
  }
}

GET/analytics/audience?period=month

نمو الجمهور وتوزيع المتابعين

يعيد إجمالي الجمهور والمتابعين الجدد وبيانات النمو والتفاعل وتوزيع المتابعين حسب المنصة وبيانات حداثة البيانات بالاستناد إلى اللقطات وسجل التحليلات المخزن مؤقتاً.

يتطلب نطاق readخطة Starter أو أعلى

الطلب

curl -X GET "https://tareno.co/api/external/analytics/audience?period=month" \
  -H "Authorization: Bearer tk_live_your_key"

الاستجابة

{
  "totalAudience": { "value": "12.4K", "change": "+5.2%" },
  "newFollowers": { "value": "613", "change": "+5.2%" }
}

GET/analytics/{platform}?accountId=acc_instagram_123&period=month

تفاصيل التحليلات الخاصة بالمنصة

يعيد بنية التحليلات الأصلية للمنصة نفسها المستخدمة في لوحة التحكم. يمكنك تمرير accountId لاستهداف حساب متصل واحد، وإلا فسيُستخدم أول حساب مطابق.

المدعوم: instagram وfacebook وtiktok وyoutube وpinterest وthreads وtwitter وlinkedin

الطلب

curl -X GET "https://tareno.co/api/external/analytics/instagram?accountId=acc_instagram_123&period=month" \
  -H "Authorization: Bearer tk_live_your_key"

الاستجابة

{
  "account": {
    "id": "acc_instagram_123",
    "username": "yourhandle",
    "followersCount": 5420
  },
  "metrics": {
    "followers": 5420,
    "periodImpressions": 38210
  }
}

GET/analytics/strategy?period=month&provider=youtube

استراتيجية محتوى بالذكاء الاصطناعي من بياناتك

ينشئ ملفاً استراتيجياً من منشوراتك ومكتبة الوسائط ونصوص مقاطع الذكاء الاصطناعي ولقطات التحليلات ومقاييس المنصة المخزنة مؤقتاً وإشارات التخصص وقواعد التوصيات.

يتطلب نطاق readخطة Starter أو أعلىاختياري: provider وaccountId

الطلب

curl -X GET "https://tareno.co/api/external/analytics/strategy?period=month&provider=youtube" \
  -H "Authorization: Bearer tk_live_your_key"

الاستجابة

{
  "videoStrategy": {
    "bestDurationBucket": "21-35s",
    "topHookType": "question"
  },
  "recommendations": [
    "Test sharper problem-based openings for 5-8 consecutive Shorts."
  ]
}

مسارات عمل التصيير

أمثلة لمسارات الدفعية

تفيد هذه الأمثلة مسارات التصيير وخوادم الأتمتة التي تريد إضافة أصول كثيرة إلى المسودات أو الجداول.

إضافة دفعات التصيير إلى المسودات

TARENO_API_KEY=tk_live_your_key \
npm run remotion:push-tareno-api -- --mode=draft VAR-061

جدولة دفعية مع ربط حسابات صريح

TARENO_API_KEY=tk_live_your_key \
TARENO_ACCOUNT_MAP='{"instagram":"acc_instagram_123"}' \
npm run remotion:push-tareno-api -- \
  --mode=schedule \
  --scheduled-at=2026-04-20T09:00:00

الأخطاء

نمط الاستجابة الشائع

تُعاد الأخطاء بصيغة JSON وقد تتضمن رسالة إضافية أو تفاصيل أو تلميحاً خاصاً بالمنصة تبعاً لنقطة النهاية.

{
  "error": "Error message here",
  "message": "Optional extra details",
  "details": "Platform-specific context"
}

الرمز	المعنى
400	معلمات غير صالحة أو قيم مطلوبة مفقودة
401	مفتاح API مفقود أو غير صالح أو منتهي الصلاحية أو ملغى
403	نطاق مفقود أو تحليلات غير متاحة في الخطة الحالية
404	لم يتم العثور على الحساب أو اللوحة أو المزود أو المورد
429	تم تقييد المعدل من المنصة أو المزود السابق
500	خطأ خادم غير متوقع

الحدود

حصص استدعاءات API الشهرية

تُطبق حدود الاستخدام لكل خطة ويمكن فحصها برمجياً عبر نقطة النهاية /usage.

الخطة	استدعاءات API الشهرية
Free	غير مشمول
Starter	غير مشمول
Pro	2,000
Business	غير محدود

واجهة Tareno API للمسودات والجدولة ورفع الوسائط والاستخدام والتحليلات

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

https://tareno.co/api/external

أفضل استخدام مع

تحكّم في Tareno من Codex أو Claude Code أو Cursor

رؤوس مفاتيح API والنطاقات

curl -X POST "https://tareno.co/api/external/publish" \ -H "Authorization: Bearer tk_live_your_key" \ -H "Content-Type: application/json" \ -d '{"mode":"draft","platform":"instagram","text":"Caption"}'

{ "posts": [{ "id": "post_123", "title": "Spring promo", "text": "Published caption", "status": "published", "platform": "instagram", "accountId": "acc_123", "publishedAt": "2026-07-09T10:00:00.000Z" }] }

curl -X POST "https://tareno.co/api/external/zapier/subscriptions" \ -H "Authorization: Bearer tk_live_your_key" \ -H "Content-Type: application/json" \ -d '{"targetUrl":"https://hooks.zapier.com/hooks/standard/123/abc","accountId":"acc_123","platform":"instagram"}'

curl -X POST "https://tareno.co/api/external/publish" \ -H "Authorization: Bearer tk_live_your_key" \ -H "Content-Type: application/json" \ -d '{ "mode": "schedule", "accountId": "acc_instagram_123", "title": "Spring promo", "text": "Caption from your automation", "mediaUrls": ["https://pub.example.com/video.mp4"], "scheduledAt": "2026-04-20T09:00:00", "timezone": "Europe/Berlin" }'

{ "success": true, "postId": "post_123", "status": "scheduled", "scheduledAt": "2026-04-20T07:00:00.000Z" } // Immediate TikTok Photo Mode may return: { "success": true, "postId": "post_123", "publishId": "v_pub_123", "status": "processing" }

الرمز

المعنى

400

معلمات غير صالحة أو قيم مطلوبة مفقودة

401

مفتاح API مفقود أو غير صالح أو منتهي الصلاحية أو ملغى

403

نطاق مفقود أو تحليلات غير متاحة في الخطة الحالية

404

لم يتم العثور على الحساب أو اللوحة أو المزود أو المورد

429

تم تقييد المعدل من المنصة أو المزود السابق

500

خطأ خادم غير متوقع

الخطة

استدعاءات API الشهرية

Free

غير مشمول

Starter

غير مشمول

Pro

2,000

Business

غير محدود