أضف النشر إلى منتجك.

شرح تطبيقي

1. 01

   تصميم تأكيد المنتج قبل استدعاء API

   فتح هذا القسم في SosoAPI

   • في تطبيق SosoAPI، اختر مساحة العمل المقصودة وراجع حسابها المتصل. في نموذج منتجك، اعرض مساحة العمل والحساب اللذين اختارهما المستخدم، ولا تختارهما بصمت.

   • اعرض النص والحساب والوقت المحلي والمنطقة الزمنية بدقة في خطوة تأكيد. اشترط اختيار الشخص Schedule؛ فتح النموذج يجب ألا يرسل شيئاً.

   ما الذي تتوقعه

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

2. 02

   قراءة Scheduled Posts الحالية من خادمك

   • استبدل <workspace-uuid> بمعرّف مساحة العمل المحددة ثم شغّل طلب القراءة فقط هذا على خادمك:

   • const apiKey = process.env.SOSOAPI_API_KEY;
     if (!apiKey) throw new Error("Configure a SosoAPI API key on your server");
     const response = await fetch(
       "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/list",
       {
         method: "POST",
         headers: {
           "Authorization": "Bearer " + apiKey,
           "Content-Type": "application/json"
         },
         body: JSON.stringify({"workspace_id":"<workspace-uuid>"})
       }
     );
     const result = await response.json();
     if (!response.ok) throw new Error("SosoAPI request failed: " + response.status);
     // Use result in your server response; never return or log the API key.

   • استخدم البيانات المُعادة لتحديث قائمة منتجك. أبقِ تأكيد المستخدم منفصلاً عن هذه القراءة.

   ما الذي تتوقعه

   تحصل على المنشورات الحالية لمساحة العمل أو خطأ تفويض/تحقّق. طلب القراءة فقط هذا لا ينشئ منشورات.

3. 03

   الإرسال فقط بعد تأكيد المستخدم الصريح

   • افتح Calendar واختر New Post لمقارنة خطوة المراجعة بالإجراء نفسه داخل التطبيق.

   • استبدل كل عنصر نائب بمعرّفاتك المفوّضة وطابع ISO زمني مستقبلي مع إزاحة ومفتاح منع تكرار فريد. راجع الحساب والنص والوقت قبل طلب الخادم.

   • const apiKey = process.env.SOSOAPI_API_KEY;
     if (!apiKey) throw new Error("Configure a SosoAPI API key on your server");
     const response = await fetch(
       "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/create",
       {
         method: "POST",
         headers: {
           "Authorization": "Bearer " + apiKey,
           "Content-Type": "application/json"
         },
         body: JSON.stringify({
       "workspace_id": "<workspace-uuid>",
       "social_account_id": "<threads-social-account-uuid>",
       "caption": "A small note for later: Harborlight Journal is making room for shorter daily reflections. Keep one thought; leave the rest for tomorrow.",
       "hashtags": [],
       "media": [],
       "provider_payload": {"platform": "threads", "publish_options": {"post_type": "TEXT"}},
       "scheduled_at": "<future ISO-8601 instant with offset>",
       "display_timezone": "Asia/Hong_Kong",
       "idempotency_key": "<unique-stable-key-for-this-intent>"
     })
       }
     );
     const result = await response.json();
     if (!response.ok) throw new Error("SosoAPI request failed: " + response.status);
     // Use result in your server response; never return or log the API key.

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

   ما الذي تتوقعه

   تحدد الاستجابة المقبولة الصالحة Scheduled Post الناتج؛ ولا تثبت نشر المزوّد. رفض إمكانية أونطاق/حساب غير صالح أوحمولة غير مدعومة أوجدول مرفوض يجب إظهاره خطأً، لا نجاحاً.

4. 04

   عرض الحالة المُعادة ومنح المستخدم خطوة متابعة آمنة

   فتح هذا القسم في SosoAPI

   • خزّن معرّف Scheduled Post المُعاد واعرض حالته الحالية ووجهته وجدوله في المنتج.

   • اربط المستخدم بتفاصيل Scheduled Post المطابق. إذا احتاج التسليم إلى شخص، اربط عنصر Needs Attention بدلاً من إعادة الإرسال بصمت.

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

   ما الذي تتوقعه

   يميّز المنتج إيصال الطلب عن ملاحظات scheduled و publishing و published و failed و unknown. تُسوّى النتائج المجهولة مقابل المنشور الموجود قبل كتابة جديدة.