الانتقال إلى المحتوى
shareto

ShareTo API

انشر من شيفرتك الخاصة

واجهة REST واحدة لربط الحسابات ونشر المنشورات أو جدولتها على Instagram وFacebook وYouTube وLinkedIn وTikTok. أنشئ ما تحتاجه من مفاتيح API.

العنوان الأساسيhttps://shareto.social/api/v1

  1. المصادقة

    أنشئ مفتاحًا من الإعدادات، قسم API، وأرسله رمزًا من نوع Bearer مع كل طلب. عدد المفاتيح غير محدود، ويظهر كل مفتاح مرة واحدة فقط، ويمكنك إلغاؤه في أي وقت.

    curl https://shareto.social/api/v1/accounts \
      -H "Authorization: Bearer st_live_..."
  2. ربط حساب

    اطلب رابط ربط وافتحه في المتصفح أو أرسله إلى صاحب الحساب. يوافق صاحب الحساب على المنصة ثم يعود إلى عنوان redirectUrl الخاص بك. يبقى الرابط صالحًا 30 دقيقة.

    curl -X POST https://shareto.social/api/v1/accounts/connect \
      -H "Authorization: Bearer st_live_..." \
      -H "Content-Type: application/json" \
      -d '{ "platform": "tiktok", "redirectUrl": "https://example.com/done" }'
    
    # 201
    { "data": { "url": "https://shareto.social/api/connect/tiktok?t=...",
                "expiresAt": "2026-11-10T10:30:00.000Z" } }
  3. رفع الوسائط

    احصل على إذن رفع ثم أرسل الملف بطريقة PUT إلى putUrl. يمكن استئناف رفع الفيديوهات الكبيرة عبر tus. استخدم قيمة url المُعادة في منشورك.

    curl -X POST https://shareto.social/api/v1/uploads \
      -H "Authorization: Bearer st_live_..." \
      -H "Content-Type: application/json" \
      -d '{ "filename": "launch.mp4", "contentType": "video/mp4" }'
    
    curl -X PUT "$PUT_URL" \
      -H "Authorization: Bearer $UPLOAD_TOKEN" \
      -H "Content-Type: video/mp4" \
      --data-binary @launch.mp4
  4. النشر أو الجدولة

    أرسل النص والوسائط ومعرّفات الحسابات. اترك scheduledAt فارغًا للنشر فورًا، أو حدّد وقتًا بصيغة ISO للجدولة. لكل حساب حالته الخاصة.

    curl -X POST https://shareto.social/api/v1/posts \
      -H "Authorization: Bearer st_live_..." \
      -H "Content-Type: application/json" \
      -d '{
        "kind": "reel",
        "caption": "Behind the scenes",
        "media": [{ "url": "$MEDIA_URL", "type": "video" }],
        "accountIds": ["$ACCOUNT_ID"],
        "scheduledAt": "2026-11-12T09:00:00Z"
      }'

نقاط النهاية

الطريقةالمسارالوظيفة
GET/accountsعرض الحسابات المرتبطة
GET/accounts/{id}جلب حساب واحد
POST/accounts/connectإنشاء رابط ربط لمنصة
DELETE/accounts/{id}فصل حساب وإلغاء منشوراته المجدولة
POST/uploadsالحصول على إذن رفع لمرة واحدة لملف
POST/postsالنشر فورًا أو جدولة منشور
GET/posts?ids=a,bجلب آخر 50 منشورًا أو المنشورات المحددة في ids
GET/posts/{id}جلب منشور مع حالة كل حساب
DELETE/posts/{id}حذف منشور لم يُنشر بعد

طرق الربط

يرتبط الحساب عبر Zernio، وهي واجهة نشر شريكة وافقت المنصات على تطبيقاتها للنشر العام، أو مباشرة عبر تطبيقات ShareTo الخاصة. أرسل connection بالقيمة auto أو zernio أو direct، ويختار auto الطريق المناسب لكل منصة.

الأخطاء

تصل الأخطاء بصيغة JSON مع حقل message: الرمز 401 عند غياب المفتاح أو خطئه، و404 إذا لم يكن العنصر في مساحة عملك، و422 إذا خالف الطلب قاعدة من قواعد المنصة. وتوضح الرسالة ما يجب تغييره.

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