المنصاتاعرض المنصات

المنصات

اعرض المنصات

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

GEThttps://api.sofia-post.com/api/v1/platforms
GET/v1/platforms
curl -X GET 'https://api.sofia-post.com/api/v1/platforms' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

التفويضات

  • Authorizationstringمطلوب

    مفتاحك الشخصي أو رمز وصول OAuth، يُرسل كـ Bearer <token>.

الاستجابة

200application/json

قائمة المنصات وقواعدها.

  • dataobject[]مطلوب

    المنصات

    عرض الخصائص الفرعية
    • platformstringمطلوب

      معرّف الشبكة

      القيم المسموحة: instagramfacebookxlinkedintiktok

    • namestringمطلوب

      اسم عرض الشبكة

    • availablebooleanمطلوب

      متاحة للشخص الذي يتصرف الرمز نيابةً عنه؛ وإلا يُرفض المنشور هناك

    • captionobjectمطلوب

      قواعد النص المصاحب

      عرض الخصائص الفرعية
      • maxLengthnumberمطلوب

        الحد الأقصى للأحرف (موزونة على X)

      • enforcedbooleanمطلوب

        true: ترفض الشبكة بشكل قاطع ما يتجاوز الحدود (422 post_refused)

      • maxHashtagsnumber

        الحد الأقصى للهاشتاغات

      • maxMentionsnumber

        الحد الأقصى للإشارات

      • threadobject

        تظهر عندما تنشر الشبكة سلسلة

        عرض الخصائص الفرعية
        • maxPostsnumberمطلوب

          الحد الأقصى لعدد المنشورات في سلسلة

    • mediaobjectمطلوب

      قواعد الوسائط

      عرض الخصائص الفرعية
      • maxCountnumberمطلوب

        الحد الأقصى لعدد الوسائط في منشور

      • enforcedbooleanمطلوب

        true: ترفض الشبكة بشكل قاطع ما يتجاوز الحد

      • mixImagesAndVideobooleanمطلوب

        false: لا يمكن الجمع بين الصور والفيديو في منشور واحد

      • imageTypesstring[]مطلوب

        أنواع MIME المقبولة للصور

      • videoTypesstring[]مطلوب

        أنواع MIME المقبولة للفيديو

    • formatsobject[]مطلوب

      الصيغ التي تقبلها الشبكة

      عرض الخصائص الفرعية
      • formatstringمطلوب

        اسم الصيغة

      • defaultbooleanمطلوب

        الصيغة المستخدمة عندما لا يحدد الهدف صيغة

      • requiredMediastringمطلوب

        none: قابل للنشر دون مرئية؛ any: مرئية من أي نوع

        القيم المسموحة: noneimagevideoany

      • captionPublishedbooleanمطلوب

        false: لا يُرسل النص المصاحب (ستوري)

4XXapplication/json

أي خطأ آخر، ضمن غلاف الخطأ.