يُحمّل البحث عند استخدامه فقط. تصفّح جميع الفئات أدناه.

الجدولة والنشر

جلب أهلية المنشور المجدول

فحص تمهيدي للقراءة فقط لكل وجهة. ضمّن draft ‏(caption و hashtags و scheduled_at و display_timezone والوقت المحلي/DST اختيارياً) لفحص المحتوى والتوقيت؛ يضيف include_quota=true لقطة استشارية للفترة. ارفع/استورد وانتظر الجاهزية أولاً. دون draft، يُفحص الحساب/الوسائط فقط. لا يحجز شيئاً؛ يعيد create/dispatch فحص الحدود والصلاحيات.

POST /studio-api/scheduled-posts/eligibility

مراجعة العقد: · sha256:563d2d581da0ad29

نظرة عامة

فحص تمهيدي للقراءة فقط لكل وجهة. ضمّن draft ‏(caption و hashtags و scheduled_at و display_timezone والوقت المحلي/DST اختيارياً) لفحص المحتوى والتوقيت؛ يضيف include_quota=true لقطة استشارية للفترة. ارفع/استورد وانتظر الجاهزية أولاً. دون draft، يُفحص الحساب/الوسائط فقط. لا يحجز شيئاً؛ يعيد create/dispatch فحص الحدود والصلاحيات.

قد يعني نجاح HTTP قبول الطلب لا اكتماله. للعمل الخلفي، احفظ المعرّف المُعاد وتابع العملية نفسها حتى تنتهي. لا يُعدّ المنشور المجدول أوالمقبول منشوراً حتى تأكيد المنصة؛ انتهاء مهلة العميل لا يثبت النتيجة.

المصادقة والأذونات

فئات بيانات الاعتماد المقبولة
user_session, delegated_oauth, personal_access_token
إمكانية مفوّضة
agent:operate
الحد الأدنى لدور مساحة العمل
viewer
نطاق الوصول
الموارد التي يحق لهذا المستخدم الوصول إليها
تلزم موافقة تشمل جميع مساحات العمل
لا
يغيّر الحالة
لا
متى تُعدّ العملية مكتملة
synchronous_http_response

لا يستخدم الرمز إلا حقوق مالكه. يفحص كل طلب عضوية مساحة العمل وملكية المورد والمساحات المحددة والإمكانات الممنوحة. يغيّر core و full الأدوات المعروضة؛ ولا يمنحان وصولاً.

حقول الطلب

تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.

حقول الطلب
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب
  • additionalProperties: false
workspace_idstringمطلوب في العنصر الأب
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
include_quotabooleanاختياري / عنصر—
targetsarrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 50
targets[]objectاختياري / عنصر
  • additionalProperties: false
targets[].social_account_idstringمطلوب في العنصر الأب
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
targets[].mediaarrayمطلوب في العنصر الأب
  • maxItems: 20
targets[].media[]objectاختياري / عنصر
  • additionalProperties: false
targets[].media[].kindstringمطلوب في العنصر الأب
  • enum: ["image","video"]
targets[].media[].urlstringمطلوب في العنصر الأب
  • format: "uri"
targets[].media[].cover_urlstring | nullاختياري / عنصر—
targets[].media[].cover_urlanyOf 1stringاختياري / عنصر
  • format: "uri"
targets[].media[].cover_urlanyOf 2nullاختياري / عنصر—
targets[].media[].cover_asset_idinteger | nullاختياري / عنصر—
targets[].media[].cover_asset_idanyOf 1integerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
targets[].media[].cover_asset_idanyOf 2nullاختياري / عنصر—
targets[].media[].asset_idinteger | nullاختياري / عنصر—
targets[].media[].asset_idanyOf 1integerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
targets[].media[].asset_idanyOf 2nullاختياري / عنصر—
targets[].media[].mime_typestring | nullاختياري / عنصر—
targets[].media[].mime_typeanyOf 1stringاختياري / عنصر
  • minLength: 1
  • maxLength: 160
targets[].media[].mime_typeanyOf 2nullاختياري / عنصر—
targets[].link_urlstring | nullاختياري / عنصر—
targets[].link_urlanyOf 1stringاختياري / عنصر
  • format: "uri"
targets[].link_urlanyOf 2nullاختياري / عنصر—
targets[].provider_payloadobjectمطلوب في العنصر الأب—
targets[].provider_payloadoneOf 1objectمطلوب في العنصر الأب
  • additionalProperties: false
targets[].provider_payload.platformoneOf 1stringمطلوب في العنصر الأب
  • const: "x"
targets[].provider_payload.publish_optionsoneOf 1objectمطلوب في العنصر الأب
  • additionalProperties: false
targets[].provider_payload.publish_options.post_typeoneOf 1stringمطلوب في العنصر الأب
  • const: "TEXT"
targets[].provider_payloadoneOf 2objectمطلوب في العنصر الأب
  • additionalProperties: false
targets[].provider_payload.platformoneOf 2stringمطلوب في العنصر الأب
  • const: "instagram"
targets[].provider_payload.publish_optionsoneOf 2objectمطلوب في العنصر الأب
  • additionalProperties: false
targets[].provider_payload.publish_options.post_typeoneOf 2stringمطلوب في العنصر الأب
  • enum: ["IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO"]
targets[].provider_payload.publish_options.location_idoneOf 2stringاختياري / عنصر
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.share_to_feedoneOf 2booleanاختياري / عنصر—
targets[].provider_payload.publish_options.collaboratorsoneOf 2arrayاختياري / عنصر
  • maxItems: 3
targets[].provider_payload.publish_options.collaborators[]oneOf 2stringاختياري / عنصر
  • minLength: 1
  • maxLength: 30
targets[].provider_payload.publish_options.first_commentoneOf 2stringاختياري / عنصر
  • minLength: 1
  • maxLength: 2200
targets[].provider_payload.publish_options.cover_asset_idoneOf 2integerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
targets[].provider_payload.publish_options.thumb_offset_msoneOf 2integerاختياري / عنصر
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.audio_nameoneOf 2stringاختياري / عنصر
  • minLength: 1
  • maxLength: 100
targets[].provider_payload.publish_options.trial_paramsoneOf 2objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.trial_params.graduation_strategyoneOf 2stringمطلوب في العنصر الأب
  • enum: ["MANUAL","SS_PERFORMANCE"]
targets[].provider_payload.publish_options.is_ai_generatedoneOf 2booleanاختياري / عنصر—
targets[].provider_payload.publish_options.branded_content_sponsor_idsoneOf 2arrayاختياري / عنصر
  • maxItems: 2
targets[].provider_payload.publish_options.branded_content_sponsor_ids[]oneOf 2stringاختياري / عنصر
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.is_paid_partnershiponeOf 2booleanاختياري / عنصر—
targets[].provider_payload.publish_options.media_optionsoneOf 2arrayاختياري / عنصر
  • maxItems: 10
targets[].provider_payload.publish_options.media_options[]oneOf 2objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.media_options[].asset_idoneOf 2integerمطلوب في العنصر الأب
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
targets[].provider_payload.publish_options.media_options[].alt_textoneOf 2stringاختياري / عنصر
  • minLength: 1
  • maxLength: 1000
targets[].provider_payload.publish_options.media_options[].user_tagsoneOf 2arrayاختياري / عنصر
  • maxItems: 20
targets[].provider_payload.publish_options.media_options[].user_tags[]oneOf 2objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.media_options[].user_tags[].usernameoneOf 2stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 30
targets[].provider_payload.publish_options.media_options[].user_tags[].xoneOf 2numberاختياري / عنصر
  • minimum: 0
  • maximum: 1
targets[].provider_payload.publish_options.media_options[].user_tags[].yoneOf 2numberاختياري / عنصر
  • minimum: 0
  • maximum: 1
targets[].provider_payload.publish_options.media_options[].product_tagsoneOf 2arrayاختياري / عنصر
  • maxItems: 5
targets[].provider_payload.publish_options.media_options[].product_tags[]oneOf 2objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.media_options[].product_tags[].product_idoneOf 2stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.media_options[].product_tags[].xoneOf 2numberاختياري / عنصر
  • minimum: 0
  • maximum: 1
targets[].provider_payload.publish_options.media_options[].product_tags[].yoneOf 2numberاختياري / عنصر
  • minimum: 0
  • maximum: 1
targets[].provider_payload.publish_options.media_options[].thumb_offset_msoneOf 2integerاختياري / عنصر
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payloadoneOf 3objectمطلوب في العنصر الأب
  • additionalProperties: false
targets[].provider_payload.platformoneOf 3stringمطلوب في العنصر الأب
  • const: "facebook"
targets[].provider_payload.publish_optionsoneOf 3objectمطلوب في العنصر الأب
  • additionalProperties: false
targets[].provider_payload.publish_options.post_typeoneOf 3stringمطلوب في العنصر الأب
  • enum: ["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","REELS","STORY_IMAGE","STORY_VIDEO"]
targets[].provider_payload.publish_options.titleoneOf 3stringاختياري / عنصر
  • maxLength: 255
targets[].provider_payload.publish_options.descriptiononeOf 3stringاختياري / عنصر
  • maxLength: 5000
targets[].provider_payload.publish_options.publication_modeoneOf 3stringاختياري / عنصر
  • enum: ["PUBLISH","DRAFT"]
targets[].provider_payload.publish_options.backdated_timeoneOf 3numberاختياري / عنصر—
targets[].provider_payload.publish_options.backdated_time_granularityoneOf 3stringاختياري / عنصر
  • enum: ["year","month","day","hour","minute"]
targets[].provider_payload.publish_options.placeoneOf 3stringاختياري / عنصر
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.tagsoneOf 3arrayاختياري / عنصر
  • maxItems: 50
targets[].provider_payload.publish_options.tags[]oneOf 3stringاختياري / عنصر
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.feed_targetingoneOf 3objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.feed_targeting.age_minoneOf 3integerاختياري / عنصر
  • minimum: 13
  • maximum: 65
targets[].provider_payload.publish_options.feed_targeting.age_maxoneOf 3integerاختياري / عنصر
  • minimum: 13
  • maximum: 65
targets[].provider_payload.publish_options.feed_targeting.college_yearsoneOf 3arrayاختياري / عنصر
  • maxItems: 100
targets[].provider_payload.publish_options.feed_targeting.college_years[]oneOf 3integerاختياري / عنصر
  • minimum: 1900
  • maximum: 2200
targets[].provider_payload.publish_options.feed_targeting.education_statusesoneOf 3arrayاختياري / عنصر
  • maxItems: 3
targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3numberاختياري / عنصر—
targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 1numberاختياري / عنصر
  • const: 1
targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 2numberاختياري / عنصر
  • const: 2
targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 3numberاختياري / عنصر
  • const: 3
targets[].provider_payload.publish_options.feed_targeting.gendersoneOf 3arrayاختياري / عنصر
  • maxItems: 2
targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3numberاختياري / عنصر—
targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3 / anyOf 1numberاختياري / عنصر
  • const: 1
targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3 / anyOf 2numberاختياري / عنصر
  • const: 2
targets[].provider_payload.publish_options.feed_targeting.geo_locationsoneOf 3objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.feed_targeting.geo_locations.countriesoneOf 3arrayاختياري / عنصر
  • minItems: 1
  • maxItems: 25
targets[].provider_payload.publish_options.feed_targeting.geo_locations.countries[]oneOf 3stringاختياري / عنصر
  • pattern: "^[A-Z]{2}$"
targets[].provider_payload.publish_options.feed_targeting.geo_locations.regionsoneOf 3arrayاختياري / عنصر
  • minItems: 1
  • maxItems: 250
targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[]oneOf 3objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3string | integerمطلوب في العنصر الأب—
targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 / anyOf 1stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 / anyOf 2integerمطلوب في العنصر الأب
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.feed_targeting.geo_locations.citiesoneOf 3arrayاختياري / عنصر
  • minItems: 1
  • maxItems: 250
targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[]oneOf 3objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3string | integerمطلوب في العنصر الأب—
targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 / anyOf 1stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 / anyOf 2integerمطلوب في العنصر الأب
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].radiusoneOf 3numberاختياري / عنصر
  • maximum: 1000
  • exclusiveMinimum: 0
targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].distance_unitoneOf 3stringاختياري / عنصر
  • enum: ["mile","kilometer"]
targets[].provider_payload.publish_options.feed_targeting.geo_locations.zipsoneOf 3arrayاختياري / عنصر
  • minItems: 1
  • maxItems: 250
targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[]oneOf 3objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3string | integerمطلوب في العنصر الأب—
targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 / anyOf 1stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 / anyOf 2integerمطلوب في العنصر الأب
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.feed_targeting.geo_locations.location_typesoneOf 3arrayاختياري / عنصر
  • minItems: 1
  • maxItems: 2
targets[].provider_payload.publish_options.feed_targeting.geo_locations.location_types[]oneOf 3stringاختياري / عنصر
  • enum: ["home","recent"]
targets[].provider_payload.publish_options.feed_targeting.interestsoneOf 3arrayاختياري / عنصر
  • maxItems: 250
targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3string | integerاختياري / عنصر—
targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3 / anyOf 1stringاختياري / عنصر
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3 / anyOf 2integerاختياري / عنصر
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.feed_targeting.localesoneOf 3arrayاختياري / عنصر
  • maxItems: 250
targets[].provider_payload.publish_options.feed_targeting.locales[]oneOf 3integerاختياري / عنصر
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.feed_targeting.relationship_statusesoneOf 3arrayاختياري / عنصر
  • maxItems: 4
targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3numberاختياري / عنصر—
targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 1numberاختياري / عنصر
  • const: 1
targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 2numberاختياري / عنصر
  • const: 2
targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 3numberاختياري / عنصر
  • const: 3
targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 4numberاختياري / عنصر
  • const: 4
targets[].provider_payload.publish_options.targetingoneOf 3objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.targeting.age_minoneOf 3numberاختياري / عنصر—
targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 1numberاختياري / عنصر
  • const: 13
targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 2numberاختياري / عنصر
  • const: 15
targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 3numberاختياري / عنصر
  • const: 18
targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 4numberاختياري / عنصر
  • const: 21
targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 5numberاختياري / عنصر
  • const: 25
targets[].provider_payload.publish_options.targeting.geo_locationsoneOf 3objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.targeting.geo_locations.countriesoneOf 3arrayاختياري / عنصر
  • minItems: 1
  • maxItems: 25
targets[].provider_payload.publish_options.targeting.geo_locations.countries[]oneOf 3stringاختياري / عنصر
  • pattern: "^[A-Z]{2}$"
targets[].provider_payload.publish_options.targeting.geo_locations.regionsoneOf 3arrayاختياري / عنصر
  • minItems: 1
  • maxItems: 250
targets[].provider_payload.publish_options.targeting.geo_locations.regions[]oneOf 3objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3string | integerمطلوب في العنصر الأب—
targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 / anyOf 1stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 / anyOf 2integerمطلوب في العنصر الأب
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.targeting.geo_locations.citiesoneOf 3arrayاختياري / عنصر
  • minItems: 1
  • maxItems: 250
targets[].provider_payload.publish_options.targeting.geo_locations.cities[]oneOf 3objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3string | integerمطلوب في العنصر الأب—
targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 / anyOf 1stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 / anyOf 2integerمطلوب في العنصر الأب
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.targeting.geo_locations.cities[].radiusoneOf 3numberاختياري / عنصر
  • maximum: 1000
  • exclusiveMinimum: 0
targets[].provider_payload.publish_options.targeting.geo_locations.cities[].distance_unitoneOf 3stringاختياري / عنصر
  • enum: ["mile","kilometer"]
targets[].provider_payload.publish_options.targeting.geo_locations.zipsoneOf 3arrayاختياري / عنصر
  • minItems: 1
  • maxItems: 250
targets[].provider_payload.publish_options.targeting.geo_locations.zips[]oneOf 3objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3string | integerمطلوب في العنصر الأب—
targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 / anyOf 1stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 / anyOf 2integerمطلوب في العنصر الأب
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.targeting.geo_locations.location_typesoneOf 3arrayاختياري / عنصر
  • minItems: 1
  • maxItems: 2
targets[].provider_payload.publish_options.targeting.geo_locations.location_types[]oneOf 3stringاختياري / عنصر
  • enum: ["home","recent"]
targets[].provider_payload.publish_options.child_attachmentsoneOf 3arrayاختياري / عنصر
  • minItems: 2
  • maxItems: 10
targets[].provider_payload.publish_options.child_attachments[]oneOf 3objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.child_attachments[].linkoneOf 3stringمطلوب في العنصر الأب
  • format: "uri"
targets[].provider_payload.publish_options.child_attachments[].nameoneOf 3stringاختياري / عنصر
  • maxLength: 255
targets[].provider_payload.publish_options.child_attachments[].descriptiononeOf 3stringاختياري / عنصر
  • maxLength: 1000
targets[].provider_payload.publish_options.child_attachments[].pictureoneOf 3stringمطلوب في العنصر الأب
  • format: "uri"
targets[].provider_payload.publish_options.multi_share_end_cardoneOf 3booleanاختياري / عنصر—
targets[].provider_payload.publish_options.multi_share_optimizedoneOf 3booleanاختياري / عنصر—
targets[].provider_payload.publish_options.unpublished_content_typeoneOf 3stringاختياري / عنصر
  • enum: ["SCHEDULED","SCHEDULED_RECURRING","DRAFT","PUBLISH_PENDING","ADS_POST","INLINE_CREATED","PUBLISHED","REVIEWABLE_BRANDED_CONTENT"]
targets[].provider_payload.publish_options.no_storyoneOf 3booleanاختياري / عنصر—
targets[].provider_payload.publish_options.crossposted_video_idoneOf 3stringاختياري / عنصر
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.sphericaloneOf 3booleanاختياري / عنصر—
targets[].provider_payload.publish_options.media_optionsoneOf 3arrayاختياري / عنصر
  • maxItems: 20
targets[].provider_payload.publish_options.media_options[]oneOf 3objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.media_options[].asset_idoneOf 3integerمطلوب في العنصر الأب
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
targets[].provider_payload.publish_options.media_options[].alt_text_customoneOf 3stringاختياري / عنصر
  • minLength: 1
  • maxLength: 1000
targets[].provider_payloadoneOf 4objectمطلوب في العنصر الأب
  • additionalProperties: false
targets[].provider_payload.platformoneOf 4stringمطلوب في العنصر الأب
  • const: "threads"
targets[].provider_payload.publish_optionsoneOf 4objectمطلوب في العنصر الأب
  • additionalProperties: false
targets[].provider_payload.publish_options.post_typeoneOf 4stringمطلوب في العنصر الأب
  • enum: ["TEXT","IMAGE","VIDEO","CAROUSEL","REPOST"]
targets[].provider_payload.publish_options.reply_to_idoneOf 4stringاختياري / عنصر
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.quote_post_idoneOf 4stringاختياري / عنصر
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.repost_target_idoneOf 4stringاختياري / عنصر
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.reply_controloneOf 4stringاختياري / عنصر
  • enum: ["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only"]
targets[].provider_payload.publish_options.enable_reply_approvalsoneOf 4booleanاختياري / عنصر—
targets[].provider_payload.publish_options.link_attachmentoneOf 4stringاختياري / عنصر
  • format: "uri"
targets[].provider_payload.publish_options.poll_attachmentoneOf 4objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.poll_attachment.option_aoneOf 4stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 25
targets[].provider_payload.publish_options.poll_attachment.option_boneOf 4stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 25
targets[].provider_payload.publish_options.poll_attachment.option_coneOf 4stringاختياري / عنصر
  • minLength: 1
  • maxLength: 25
targets[].provider_payload.publish_options.poll_attachment.option_doneOf 4stringاختياري / عنصر
  • minLength: 1
  • maxLength: 25
targets[].provider_payload.publish_options.gif_attachmentoneOf 4objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.gif_attachment.gif_idoneOf 4stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.gif_attachment.provideroneOf 4stringمطلوب في العنصر الأب
  • const: "GIPHY"
targets[].provider_payload.publish_options.text_attachmentoneOf 4objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.text_attachment.plaintextoneOf 4stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 10000
targets[].provider_payload.publish_options.text_attachment.link_attachment_urloneOf 4stringاختياري / عنصر
  • format: "uri"
targets[].provider_payload.publish_options.text_attachment.text_with_styling_infooneOf 4arrayاختياري / عنصر
  • maxItems: 100
targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[]oneOf 4objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].offsetoneOf 4integerمطلوب في العنصر الأب
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].lengthoneOf 4integerمطلوب في العنصر الأب
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_infooneOf 4arrayمطلوب في العنصر الأب
  • minItems: 1
targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_info[]oneOf 4stringاختياري / عنصر
  • enum: ["bold","italic","highlight","underline","strikethrough"]
targets[].provider_payload.publish_options.topic_tagoneOf 4stringاختياري / عنصر
  • minLength: 1
  • maxLength: 50
targets[].provider_payload.publish_options.text_entitiesoneOf 4arrayاختياري / عنصر
  • maxItems: 10
targets[].provider_payload.publish_options.text_entities[]oneOf 4objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.text_entities[].entity_typeoneOf 4stringمطلوب في العنصر الأب
  • enum: ["SPOILER","spoiler"]
targets[].provider_payload.publish_options.text_entities[].offsetoneOf 4integerمطلوب في العنصر الأب
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.text_entities[].lengthoneOf 4integerمطلوب في العنصر الأب
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
targets[].provider_payload.publish_options.is_spoiler_mediaoneOf 4booleanاختياري / عنصر—
targets[].provider_payload.publish_options.is_ghost_postoneOf 4booleanاختياري / عنصر—
targets[].provider_payload.publish_options.location_idoneOf 4stringاختياري / عنصر
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.allowlisted_country_codesoneOf 4arrayاختياري / عنصر
  • minItems: 1
  • maxItems: 249
targets[].provider_payload.publish_options.allowlisted_country_codes[]oneOf 4stringاختياري / عنصر
  • pattern: "^[A-Z]{2}$"
targets[].provider_payload.publish_options.crossreshare_to_igoneOf 4booleanاختياري / عنصر—
targets[].provider_payload.publish_options.crossreshare_to_ig_dark_modeoneOf 4booleanاختياري / عنصر—
targets[].provider_payload.publish_options.auto_publish_textoneOf 4booleanاختياري / عنصر—
targets[].provider_payload.publish_options.media_optionsoneOf 4arrayاختياري / عنصر
  • maxItems: 20
targets[].provider_payload.publish_options.media_options[]oneOf 4objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.media_options[].asset_idoneOf 4integerمطلوب في العنصر الأب
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
targets[].provider_payload.publish_options.media_options[].alt_textoneOf 4stringاختياري / عنصر
  • minLength: 1
  • maxLength: 1000
targets[].provider_payload.publish_options.media_options[].is_spoiler_mediaoneOf 4booleanاختياري / عنصر—
targets[].provider_payloadoneOf 5objectمطلوب في العنصر الأب
  • additionalProperties: false
targets[].provider_payload.platformoneOf 5stringمطلوب في العنصر الأب
  • const: "youtube"
targets[].provider_payload.publish_optionsoneOf 5objectمطلوب في العنصر الأب
  • additionalProperties: false
targets[].provider_payload.publish_options.post_typeoneOf 5stringمطلوب في العنصر الأب
  • const: "VIDEO"
targets[].provider_payload.publish_options.titleoneOf 5stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 100
targets[].provider_payload.publish_options.descriptiononeOf 5stringاختياري / عنصر
  • maxLength: 5000
targets[].provider_payload.publish_options.tagsoneOf 5arrayاختياري / عنصر
  • maxItems: 100
targets[].provider_payload.publish_options.tags[]oneOf 5stringاختياري / عنصر
  • minLength: 1
  • maxLength: 500
targets[].provider_payload.publish_options.category_idoneOf 5stringاختياري / عنصر—
targets[].provider_payload.publish_options.category_idoneOf 5 / anyOf 1stringاختياري / عنصر
  • minLength: 0
  • maxLength: 0
targets[].provider_payload.publish_options.category_idoneOf 5 / anyOf 2stringاختياري / عنصر
  • pattern: "^\\d+$"
targets[].provider_payload.publish_options.default_languageoneOf 5stringاختياري / عنصر
  • minLength: 2
  • maxLength: 35
targets[].provider_payload.publish_options.localizationsoneOf 5objectاختياري / عنصر
  • additionalProperties: {"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":5000}},"required":["title","description"],"additionalProperties":false}
targets[].provider_payload.publish_options.localizations.*oneOf 5objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.localizations.*.titleoneOf 5stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 100
targets[].provider_payload.publish_options.localizations.*.descriptiononeOf 5stringمطلوب في العنصر الأب
  • maxLength: 5000
targets[].provider_payload.publish_options.privacy_statusoneOf 5stringمطلوب في العنصر الأب
  • enum: ["private","unlisted","public"]
targets[].provider_payload.publish_options.cancellation_modeoneOf 5stringمطلوب في العنصر الأب
  • enum: ["DELETE","UNSCHEDULE_KEEP_PRIVATE"]
targets[].provider_payload.publish_options.licenseoneOf 5stringاختياري / عنصر
  • enum: ["youtube","creativeCommon"]
targets[].provider_payload.publish_options.embeddableoneOf 5booleanاختياري / عنصر—
targets[].provider_payload.publish_options.public_stats_viewableoneOf 5booleanاختياري / عنصر—
targets[].provider_payload.publish_options.self_declared_made_for_kidsoneOf 5booleanاختياري / عنصر—
targets[].provider_payload.publish_options.contains_synthetic_mediaoneOf 5booleanاختياري / عنصر—
targets[].provider_payload.publish_options.has_paid_product_placementoneOf 5booleanاختياري / عنصر—
targets[].provider_payload.publish_options.recording_dateoneOf 5stringاختياري / عنصر
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
targets[].provider_payload.publish_options.notify_subscribersoneOf 5booleanاختياري / عنصر—
targets[].provider_payload.publish_options.thumbnail_asset_idoneOf 5integerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
targets[].provider_payload.publish_options.surface_expectationoneOf 5stringاختياري / عنصر
  • const: "SHORT"
targets[].provider_payload.publish_options.brand_partneroneOf 5objectاختياري / عنصر
  • additionalProperties: false
targets[].provider_payload.publish_options.brand_partner.channel_idoneOf 5stringاختياري / عنصر
  • pattern: "^UC[A-Za-z0-9_-]+$"
targets[].provider_payload.publish_options.brand_partner.channel_handleoneOf 5stringاختياري / عنصر
  • pattern: "^@[A-Za-z0-9._-]+$"
targets[].draftobjectاختياري / عنصر
  • additionalProperties: false
targets[].draft.captionstring | nullاختياري / عنصر
  • default: null
targets[].draft.captionanyOf 1stringاختياري / عنصر
  • maxLength: 5000
targets[].draft.captionanyOf 2nullاختياري / عنصر—
targets[].draft.hashtagsarrayاختياري / عنصر
  • maxItems: 100
  • default: []
targets[].draft.hashtags[]stringاختياري / عنصر
  • maxLength: 100
targets[].draft.scheduled_atstringمطلوب في العنصر الأب
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
targets[].draft.display_timezonestringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 80
targets[].draft.local_scheduled_atstringاختياري / عنصر
  • pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
targets[].draft.schedule_dst_disambiguationstringاختياري / عنصر
  • enum: ["exact","earlier","later"]
targets[].draft.expires_atstring | nullاختياري / عنصر—
targets[].draft.expires_atanyOf 1stringاختياري / عنصر
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
targets[].draft.expires_atanyOf 2nullاختياري / عنصر—
مخطط JSON Schema الكامل
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "include_quota": {
      "type": "boolean"
    },
    "targets": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "social_account_id": {
            "type": "string",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
          },
          "media": {
            "maxItems": 20,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string",
                  "enum": [
                    "image",
                    "video"
                  ]
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "cover_url": {
                  "anyOf": [
                    {
                      "type": "string",
                      "format": "uri"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "cover_asset_id": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "asset_id": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "mime_type": {
                  "anyOf": [
                    {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 160
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "kind",
                "url"
              ],
              "additionalProperties": false
            }
          },
          "link_url": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          },
          "provider_payload": {
            "oneOf": [
              {
                "type": "object",
                "properties": {
                  "platform": {
                    "type": "string",
                    "const": "x"
                  },
                  "publish_options": {
                    "type": "object",
                    "properties": {
                      "post_type": {
                        "type": "string",
                        "const": "TEXT"
                      }
                    },
                    "required": [
                      "post_type"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "platform",
                  "publish_options"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "platform": {
                    "type": "string",
                    "const": "instagram"
                  },
                  "publish_options": {
                    "type": "object",
                    "properties": {
                      "post_type": {
                        "type": "string",
                        "enum": [
                          "IMAGE",
                          "VIDEO",
                          "CAROUSEL",
                          "REELS",
                          "STORY_IMAGE",
                          "STORY_VIDEO"
                        ]
                      },
                      "location_id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 256
                      },
                      "share_to_feed": {
                        "type": "boolean"
                      },
                      "collaborators": {
                        "maxItems": 3,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 30
                        }
                      },
                      "first_comment": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 2200
                      },
                      "cover_asset_id": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991
                      },
                      "thumb_offset_ms": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "audio_name": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "trial_params": {
                        "type": "object",
                        "properties": {
                          "graduation_strategy": {
                            "type": "string",
                            "enum": [
                              "MANUAL",
                              "SS_PERFORMANCE"
                            ]
                          }
                        },
                        "required": [
                          "graduation_strategy"
                        ],
                        "additionalProperties": false
                      },
                      "is_ai_generated": {
                        "type": "boolean"
                      },
                      "branded_content_sponsor_ids": {
                        "maxItems": 2,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 256
                        }
                      },
                      "is_paid_partnership": {
                        "type": "boolean"
                      },
                      "media_options": {
                        "maxItems": 10,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "asset_id": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "alt_text": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1000
                            },
                            "user_tags": {
                              "maxItems": 20,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "username": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 30
                                  },
                                  "x": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  },
                                  "y": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  }
                                },
                                "required": [
                                  "username"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "product_tags": {
                              "maxItems": 5,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "product_id": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 256
                                  },
                                  "x": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  },
                                  "y": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  }
                                },
                                "required": [
                                  "product_id"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "thumb_offset_ms": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "asset_id"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "post_type"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "platform",
                  "publish_options"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "platform": {
                    "type": "string",
                    "const": "facebook"
                  },
                  "publish_options": {
                    "type": "object",
                    "properties": {
                      "post_type": {
                        "type": "string",
                        "enum": [
                          "TEXT",
                          "LINK",
                          "IMAGE",
                          "MULTI_IMAGE",
                          "VIDEO",
                          "REELS",
                          "STORY_IMAGE",
                          "STORY_VIDEO"
                        ]
                      },
                      "title": {
                        "type": "string",
                        "maxLength": 255
                      },
                      "description": {
                        "type": "string",
                        "maxLength": 5000
                      },
                      "publication_mode": {
                        "type": "string",
                        "enum": [
                          "PUBLISH",
                          "DRAFT"
                        ]
                      },
                      "backdated_time": {
                        "type": "number"
                      },
                      "backdated_time_granularity": {
                        "type": "string",
                        "enum": [
                          "year",
                          "month",
                          "day",
                          "hour",
                          "minute"
                        ]
                      },
                      "place": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 256
                      },
                      "tags": {
                        "maxItems": 50,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 256
                        }
                      },
                      "feed_targeting": {
                        "type": "object",
                        "properties": {
                          "age_min": {
                            "type": "integer",
                            "minimum": 13,
                            "maximum": 65
                          },
                          "age_max": {
                            "type": "integer",
                            "minimum": 13,
                            "maximum": 65
                          },
                          "college_years": {
                            "maxItems": 100,
                            "type": "array",
                            "items": {
                              "type": "integer",
                              "minimum": 1900,
                              "maximum": 2200
                            }
                          },
                          "education_statuses": {
                            "maxItems": 3,
                            "type": "array",
                            "items": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "const": 1
                                },
                                {
                                  "type": "number",
                                  "const": 2
                                },
                                {
                                  "type": "number",
                                  "const": 3
                                }
                              ]
                            }
                          },
                          "genders": {
                            "maxItems": 2,
                            "type": "array",
                            "items": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "const": 1
                                },
                                {
                                  "type": "number",
                                  "const": 2
                                }
                              ]
                            }
                          },
                          "geo_locations": {
                            "type": "object",
                            "properties": {
                              "countries": {
                                "minItems": 1,
                                "maxItems": 25,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^[A-Z]{2}$"
                                }
                              },
                              "regions": {
                                "minItems": 1,
                                "maxItems": 250,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "key": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 256
                                        },
                                        {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "key"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "cities": {
                                "minItems": 1,
                                "maxItems": 250,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "key": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 256
                                        },
                                        {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      ]
                                    },
                                    "radius": {
                                      "type": "number",
                                      "exclusiveMinimum": 0,
                                      "maximum": 1000
                                    },
                                    "distance_unit": {
                                      "type": "string",
                                      "enum": [
                                        "mile",
                                        "kilometer"
                                      ]
                                    }
                                  },
                                  "required": [
                                    "key"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "zips": {
                                "minItems": 1,
                                "maxItems": 250,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "key": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 256
                                        },
                                        {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "key"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "location_types": {
                                "minItems": 1,
                                "maxItems": 2,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "home",
                                    "recent"
                                  ]
                                }
                              }
                            },
                            "additionalProperties": false
                          },
                          "interests": {
                            "maxItems": 250,
                            "type": "array",
                            "items": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 256
                                },
                                {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                }
                              ]
                            }
                          },
                          "locales": {
                            "maxItems": 250,
                            "type": "array",
                            "items": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "relationship_statuses": {
                            "maxItems": 4,
                            "type": "array",
                            "items": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "const": 1
                                },
                                {
                                  "type": "number",
                                  "const": 2
                                },
                                {
                                  "type": "number",
                                  "const": 3
                                },
                                {
                                  "type": "number",
                                  "const": 4
                                }
                              ]
                            }
                          }
                        },
                        "additionalProperties": false
                      },
                      "targeting": {
                        "type": "object",
                        "properties": {
                          "age_min": {
                            "anyOf": [
                              {
                                "type": "number",
                                "const": 13
                              },
                              {
                                "type": "number",
                                "const": 15
                              },
                              {
                                "type": "number",
                                "const": 18
                              },
                              {
                                "type": "number",
                                "const": 21
                              },
                              {
                                "type": "number",
                                "const": 25
                              }
                            ]
                          },
                          "geo_locations": {
                            "type": "object",
                            "properties": {
                              "countries": {
                                "minItems": 1,
                                "maxItems": 25,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^[A-Z]{2}$"
                                }
                              },
                              "regions": {
                                "minItems": 1,
                                "maxItems": 250,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "key": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 256
                                        },
                                        {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "key"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "cities": {
                                "minItems": 1,
                                "maxItems": 250,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "key": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 256
                                        },
                                        {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      ]
                                    },
                                    "radius": {
                                      "type": "number",
                                      "exclusiveMinimum": 0,
                                      "maximum": 1000
                                    },
                                    "distance_unit": {
                                      "type": "string",
                                      "enum": [
                                        "mile",
                                        "kilometer"
                                      ]
                                    }
                                  },
                                  "required": [
                                    "key"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "zips": {
                                "minItems": 1,
                                "maxItems": 250,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "key": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 256
                                        },
                                        {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "key"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "location_types": {
                                "minItems": 1,
                                "maxItems": 2,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "home",
                                    "recent"
                                  ]
                                }
                              }
                            },
                            "additionalProperties": false
                          }
                        },
                        "additionalProperties": false
                      },
                      "child_attachments": {
                        "minItems": 2,
                        "maxItems": 10,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "link": {
                              "type": "string",
                              "format": "uri"
                            },
                            "name": {
                              "type": "string",
                              "maxLength": 255
                            },
                            "description": {
                              "type": "string",
                              "maxLength": 1000
                            },
                            "picture": {
                              "type": "string",
                              "format": "uri"
                            }
                          },
                          "required": [
                            "link",
                            "picture"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "multi_share_end_card": {
                        "type": "boolean"
                      },
                      "multi_share_optimized": {
                        "type": "boolean"
                      },
                      "unpublished_content_type": {
                        "type": "string",
                        "enum": [
                          "SCHEDULED",
                          "SCHEDULED_RECURRING",
                          "DRAFT",
                          "PUBLISH_PENDING",
                          "ADS_POST",
                          "INLINE_CREATED",
                          "PUBLISHED",
                          "REVIEWABLE_BRANDED_CONTENT"
                        ]
                      },
                      "no_story": {
                        "type": "boolean"
                      },
                      "crossposted_video_id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 256
                      },
                      "spherical": {
                        "type": "boolean"
                      },
                      "media_options": {
                        "maxItems": 20,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "asset_id": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "alt_text_custom": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1000
                            }
                          },
                          "required": [
                            "asset_id"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "post_type"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "platform",
                  "publish_options"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "platform": {
                    "type": "string",
                    "const": "threads"
                  },
                  "publish_options": {
                    "type": "object",
                    "properties": {
                      "post_type": {
                        "type": "string",
                        "enum": [
                          "TEXT",
                          "IMAGE",
                          "VIDEO",
                          "CAROUSEL",
                          "REPOST"
                        ]
                      },
                      "reply_to_id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 256
                      },
                      "quote_post_id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 256
                      },
                      "repost_target_id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 256
                      },
                      "reply_control": {
                        "type": "string",
                        "enum": [
                          "everyone",
                          "accounts_you_follow",
                          "mentioned_only",
                          "parent_post_author_only",
                          "followers_only"
                        ]
                      },
                      "enable_reply_approvals": {
                        "type": "boolean"
                      },
                      "link_attachment": {
                        "type": "string",
                        "format": "uri"
                      },
                      "poll_attachment": {
                        "type": "object",
                        "properties": {
                          "option_a": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 25
                          },
                          "option_b": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 25
                          },
                          "option_c": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 25
                          },
                          "option_d": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 25
                          }
                        },
                        "required": [
                          "option_a",
                          "option_b"
                        ],
                        "additionalProperties": false
                      },
                      "gif_attachment": {
                        "type": "object",
                        "properties": {
                          "gif_id": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 256
                          },
                          "provider": {
                            "type": "string",
                            "const": "GIPHY"
                          }
                        },
                        "required": [
                          "gif_id",
                          "provider"
                        ],
                        "additionalProperties": false
                      },
                      "text_attachment": {
                        "type": "object",
                        "properties": {
                          "plaintext": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 10000
                          },
                          "link_attachment_url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "text_with_styling_info": {
                            "maxItems": 100,
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "offset": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "length": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "styling_info": {
                                  "minItems": 1,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "enum": [
                                      "bold",
                                      "italic",
                                      "highlight",
                                      "underline",
                                      "strikethrough"
                                    ]
                                  }
                                }
                              },
                              "required": [
                                "offset",
                                "length",
                                "styling_info"
                              ],
                              "additionalProperties": false
                            }
                          }
                        },
                        "required": [
                          "plaintext"
                        ],
                        "additionalProperties": false
                      },
                      "topic_tag": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 50
                      },
                      "text_entities": {
                        "maxItems": 10,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "entity_type": {
                              "type": "string",
                              "enum": [
                                "SPOILER",
                                "spoiler"
                              ]
                            },
                            "offset": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "length": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "entity_type",
                            "offset",
                            "length"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "is_spoiler_media": {
                        "type": "boolean"
                      },
                      "is_ghost_post": {
                        "type": "boolean"
                      },
                      "location_id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 256
                      },
                      "allowlisted_country_codes": {
                        "minItems": 1,
                        "maxItems": 249,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "pattern": "^[A-Z]{2}$"
                        }
                      },
                      "crossreshare_to_ig": {
                        "type": "boolean"
                      },
                      "crossreshare_to_ig_dark_mode": {
                        "type": "boolean"
                      },
                      "auto_publish_text": {
                        "type": "boolean"
                      },
                      "media_options": {
                        "maxItems": 20,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "asset_id": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "alt_text": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1000
                            },
                            "is_spoiler_media": {
                              "type": "boolean"
                            }
                          },
                          "required": [
                            "asset_id"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "post_type"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "platform",
                  "publish_options"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "platform": {
                    "type": "string",
                    "const": "youtube"
                  },
                  "publish_options": {
                    "type": "object",
                    "properties": {
                      "post_type": {
                        "type": "string",
                        "const": "VIDEO"
                      },
                      "title": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "description": {
                        "type": "string",
                        "maxLength": 5000
                      },
                      "tags": {
                        "maxItems": 100,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 500
                        }
                      },
                      "category_id": {
                        "anyOf": [
                          {
                            "type": "string",
                            "minLength": 0,
                            "maxLength": 0
                          },
                          {
                            "type": "string",
                            "pattern": "^\\d+$"
                          }
                        ]
                      },
                      "default_language": {
                        "type": "string",
                        "minLength": 2,
                        "maxLength": 35
                      },
                      "localizations": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "object",
                          "properties": {
                            "title": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "description": {
                              "type": "string",
                              "maxLength": 5000
                            }
                          },
                          "required": [
                            "title",
                            "description"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "privacy_status": {
                        "type": "string",
                        "enum": [
                          "private",
                          "unlisted",
                          "public"
                        ]
                      },
                      "cancellation_mode": {
                        "type": "string",
                        "enum": [
                          "DELETE",
                          "UNSCHEDULE_KEEP_PRIVATE"
                        ]
                      },
                      "license": {
                        "type": "string",
                        "enum": [
                          "youtube",
                          "creativeCommon"
                        ]
                      },
                      "embeddable": {
                        "type": "boolean"
                      },
                      "public_stats_viewable": {
                        "type": "boolean"
                      },
                      "self_declared_made_for_kids": {
                        "type": "boolean"
                      },
                      "contains_synthetic_media": {
                        "type": "boolean"
                      },
                      "has_paid_product_placement": {
                        "type": "boolean"
                      },
                      "recording_date": {
                        "type": "string",
                        "format": "date-time",
                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                      },
                      "notify_subscribers": {
                        "type": "boolean"
                      },
                      "thumbnail_asset_id": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991
                      },
                      "surface_expectation": {
                        "type": "string",
                        "const": "SHORT"
                      },
                      "brand_partner": {
                        "type": "object",
                        "properties": {
                          "channel_id": {
                            "type": "string",
                            "pattern": "^UC[A-Za-z0-9_-]+$"
                          },
                          "channel_handle": {
                            "type": "string",
                            "pattern": "^@[A-Za-z0-9._-]+$"
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "post_type",
                      "title",
                      "privacy_status",
                      "cancellation_mode"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "platform",
                  "publish_options"
                ],
                "additionalProperties": false
              }
            ]
          },
          "draft": {
            "type": "object",
            "properties": {
              "caption": {
                "default": null,
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 5000
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "hashtags": {
                "default": [],
                "maxItems": 100,
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 100
                }
              },
              "scheduled_at": {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
              },
              "display_timezone": {
                "type": "string",
                "minLength": 1,
                "maxLength": 80
              },
              "local_scheduled_at": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
              },
              "schedule_dst_disambiguation": {
                "type": "string",
                "enum": [
                  "exact",
                  "earlier",
                  "later"
                ]
              },
              "expires_at": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "scheduled_at",
              "display_timezone"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "social_account_id",
          "media",
          "provider_payload"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "workspace_id",
    "targets"
  ],
  "additionalProperties": false
}

الاستجابة والاكتمال

رموز نجاح HTTP: 200. عندما تكتمل العملية: synchronous_http_response.

قد يعني نجاح HTTP قبول الطلب لا اكتماله. للعمل الخلفي، احفظ المعرّف المُعاد وتابع العملية نفسها حتى تنتهي. لا يُعدّ المنشور المجدول أوالمقبول منشوراً حتى تأكيد المنصة؛ انتهاء مهلة العميل لا يثبت النتيجة.

تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.

الاستجابة والاكتمال
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب—
destinationsarrayمطلوب في العنصر الأب
  • maxItems: 50
destinations[]objectاختياري / عنصر—
destinations[].social_account_idstringمطلوب في العنصر الأب
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
destinations[].platformstring | nullمطلوب في العنصر الأب—
destinations[].platformanyOf 1stringمطلوب في العنصر الأب
  • enum: ["instagram","threads","facebook","youtube","x"]
destinations[].platformanyOf 2nullمطلوب في العنصر الأب—
destinations[].statusstringمطلوب في العنصر الأب
  • enum: ["eligible","ineligible","unknown"]
destinations[].reason_codestringمطلوب في العنصر الأب
  • enum: ["eligible","account_not_found","account_disconnected","account_action_required","account_temporarily_unavailable","account_publishing_restricted","account_readiness_unknown","account_sponsorship_required","organization_channel_disconnected","provider_authorization_revoke_pending","organization_channel_not_primary","organization_channel_transition","organization_new_work_blocked","content_incompatible","schedule_incompatible","schedule_check_unavailable","capability_unavailable","capability_unknown"]
destinations[].messagestringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 500
destinations[].required_capabilitiesarrayمطلوب في العنصر الأب
  • maxItems: 20
destinations[].required_capabilities[]stringاختياري / عنصر
  • minLength: 1
  • maxLength: 100
quotaobjectاختياري / عنصر—
quota.statusstringمطلوب في العنصر الأب
  • enum: ["available","insufficient","unknown","not_enforced"]
quota.requested_destinationsintegerمطلوب في العنصر الأب
  • maximum: 50
  • exclusiveMinimum: 0
quota.remaining_publishesinteger | nullمطلوب في العنصر الأب—
quota.remaining_publishesanyOf 1integerمطلوب في العنصر الأب
  • minimum: 0
  • maximum: 9007199254740991
quota.remaining_publishesanyOf 2nullمطلوب في العنصر الأب—
quota.remaining_pending_postsinteger | nullمطلوب في العنصر الأب—
quota.remaining_pending_postsanyOf 1integerمطلوب في العنصر الأب
  • minimum: 0
  • maximum: 9007199254740991
quota.remaining_pending_postsanyOf 2nullمطلوب في العنصر الأب—
quota.period_startstring | nullمطلوب في العنصر الأب—
quota.period_startanyOf 1stringمطلوب في العنصر الأب
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
quota.period_startanyOf 2nullمطلوب في العنصر الأب—
quota.period_endstring | nullمطلوب في العنصر الأب—
quota.period_endanyOf 1stringمطلوب في العنصر الأب
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
quota.period_endanyOf 2nullمطلوب في العنصر الأب—
quota.checked_atstringمطلوب في العنصر الأب
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
quota.reservedbooleanمطلوب في العنصر الأب
  • const: false
مخطط JSON Schema الكامل
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "destinations": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "social_account_id": {
            "type": "string",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
          },
          "platform": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "instagram",
                  "threads",
                  "facebook",
                  "youtube",
                  "x"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "eligible",
              "ineligible",
              "unknown"
            ]
          },
          "reason_code": {
            "type": "string",
            "enum": [
              "eligible",
              "account_not_found",
              "account_disconnected",
              "account_action_required",
              "account_temporarily_unavailable",
              "account_publishing_restricted",
              "account_readiness_unknown",
              "account_sponsorship_required",
              "organization_channel_disconnected",
              "provider_authorization_revoke_pending",
              "organization_channel_not_primary",
              "organization_channel_transition",
              "organization_new_work_blocked",
              "content_incompatible",
              "schedule_incompatible",
              "schedule_check_unavailable",
              "capability_unavailable",
              "capability_unknown"
            ]
          },
          "message": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "required_capabilities": {
            "maxItems": 20,
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            }
          }
        },
        "required": [
          "social_account_id",
          "platform",
          "status",
          "reason_code",
          "message",
          "required_capabilities"
        ]
      }
    },
    "quota": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "available",
            "insufficient",
            "unknown",
            "not_enforced"
          ]
        },
        "requested_destinations": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 50
        },
        "remaining_publishes": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "remaining_pending_posts": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "period_start": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
            },
            {
              "type": "null"
            }
          ]
        },
        "period_end": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
            },
            {
              "type": "null"
            }
          ]
        },
        "checked_at": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
        },
        "reserved": {
          "type": "boolean",
          "const": false
        }
      },
      "required": [
        "status",
        "requested_destinations",
        "remaining_publishes",
        "remaining_pending_posts",
        "period_start",
        "period_end",
        "checked_at",
        "reserved"
      ]
    }
  },
  "required": [
    "destinations"
  ]
}

الأخطاء وإعادة المحاولة بأمان

افحص حالة HTTP والجسم. قد يحوي خطأ التحقق 400 ‏ZodError؛ تستخدم أخطاء المعالج error و message و code. احتفظ بـ request_id أو x-request-id للتشخيص دون اعتماد. أصلح أخطاء وصول 401/403 قبل المحاولة واتّبع Retry-After لـ 429. لكتابة غير مؤكدة أو 5xx، اقرأ الموجود أولاً. أعِد مفتاح منع التكرار حيث يُدعم فقط؛ تختلف المحاولة حسب العملية ولا تضمن التسليم مرة واحدة بالضبط.

دليل استكشاف الأخطاء وإصلاحها

أمثلة

تستخدم الأمثلة قيماً خيالية مفحوصة بالمخططات. استبدل المعرّفات بالمفوّض لك، والوسائط بأصول جاهزة، والتواريخ بوقت نشر مؤكد. افحص أهلية الحساب قبل الكتابة. لا تُرسل الصفحة طلبات API.

اضبط SOSOAPI_ACCESS_TOKEN على خادمك ببيانات اعتماد تقبلها العملية، وأبقِه خارج شيفرة المتصفح. للوكيل، استخدم sosoapi auth login للدخول بالمتصفح ودع CLI يحدّث بيانات اعتماده.

request.json

{
  "workspace_id": "11111111-1111-4111-8111-111111111111",
  "targets": [
    {
      "social_account_id": "11111111-1111-4111-8111-111111111111",
      "media": [],
      "provider_payload": {
        "platform": "x",
        "publish_options": {
          "post_type": "TEXT"
        }
      }
    }
  ]
}

cURL

curl --request POST \
  "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/eligibility" \
  -H "Authorization: Bearer $SOSOAPI_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @request.json

JavaScript

// Server-side JavaScript. Do not print tokens or credential-bearing responses.
const token = process.env.SOSOAPI_ACCESS_TOKEN;
if (!token) throw new Error("Set an accepted credential for this operation");
const response = await fetch("https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/eligibility", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
  body: JSON.stringify({
  "workspace_id": "11111111-1111-4111-8111-111111111111",
  "targets": [
    {
      "social_account_id": "11111111-1111-4111-8111-111111111111",
      "media": [],
      "provider_payload": {
        "platform": "x",
        "publish_options": {
          "post_type": "TEXT"
        }
      }
    }
  ]
})
});
const result = await response.json();
// Check response.ok, the operation-specific body and completion state before continuing.

CLI

npx sosoapi api post /studio-api/scheduled-posts/eligibility < request.json

مثال استجابة اصطناعية

{
  "destinations": []
}

MCP: sosoapi_get_scheduled_post_eligibility