SosoAPI
AR
EN繁中繁體中文（台灣）简体中文日本語한국어DeutschFrançaisEspañolPortuguês (Brasil)العربيةעבריתNederlandsहिन्दीBahasa IndonesiaNorsk bokmålSvenskaMagyar
تسجيل الدخول

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

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

جلب منشور مجدول

قراءة منشور مجدول واحد حسب id: المحتوى والحالة وحالة التسليم والنتائج. إصداره هو ما تحتاجه عمليات update و publish و retry و cancel في expected_version.

POST /studio-api/scheduled-posts/get

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

اقرأ بصيغة Markdownتنزيل العقد العامتنزيل OpenAPI

نظرة عامة

قراءة منشور مجدول واحد حسب id: المحتوى والحالة وحالة التسليم والنتائج. إصداره هو ما تحتاجه عمليات update و publish و retry و cancel في expected_version.

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

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

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

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

حقول الطلب

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

حقول الطلب
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب
  • additionalProperties: false
idstringمطلوب في العنصر الأب
  • pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
مخطط JSON Schema الكامل
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

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

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

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

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

الاستجابة والاكتمال
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب—
postobjectمطلوب في العنصر الأب—
post.idstringمطلوب في العنصر الأب
  • pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
post.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)$"
post.social_account_idstring | nullمطلوب في العنصر الأب—
post.social_account_idanyOf 1stringمطلوب في العنصر الأب
  • 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)$"
post.social_account_idanyOf 2nullمطلوب في العنصر الأب—
post.platformstringمطلوب في العنصر الأب
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destinationobjectمطلوب في العنصر الأب—
post.destination.social_account_idstring | nullمطلوب في العنصر الأب—
post.destination.social_account_idanyOf 1stringمطلوب في العنصر الأب
  • 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)$"
post.destination.social_account_idanyOf 2nullمطلوب في العنصر الأب—
post.destination.platformstringمطلوب في العنصر الأب
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destination.platform_user_idstring | nullمطلوب في العنصر الأب—
post.destination.platform_user_idanyOf 1stringمطلوب في العنصر الأب—
post.destination.platform_user_idanyOf 2nullمطلوب في العنصر الأب—
post.destination.account_labelstring | nullمطلوب في العنصر الأب—
post.destination.account_labelanyOf 1stringمطلوب في العنصر الأب—
post.destination.account_labelanyOf 2nullمطلوب في العنصر الأب—
post.captionstring | nullمطلوب في العنصر الأب—
post.captionanyOf 1stringمطلوب في العنصر الأب—
post.captionanyOf 2nullمطلوب في العنصر الأب—
post.hashtagsarrayمطلوب في العنصر الأب—
post.hashtags[]stringاختياري / عنصر—
post.mediaarrayمطلوب في العنصر الأب—
post.media[]objectاختياري / عنصر—
post.media[].kindstringمطلوب في العنصر الأب
  • enum: ["image","video"]
post.media[].urlstringمطلوب في العنصر الأب
  • format: "uri"
post.media[].cover_urlstring | nullاختياري / عنصر—
post.media[].cover_urlanyOf 1stringاختياري / عنصر
  • format: "uri"
post.media[].cover_urlanyOf 2nullاختياري / عنصر—
post.media[].cover_asset_idinteger | nullاختياري / عنصر—
post.media[].cover_asset_idanyOf 1integerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.media[].cover_asset_idanyOf 2nullاختياري / عنصر—
post.media[].asset_idinteger | nullاختياري / عنصر—
post.media[].asset_idanyOf 1integerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.media[].asset_idanyOf 2nullاختياري / عنصر—
post.media[].mime_typestring | nullاختياري / عنصر—
post.media[].mime_typeanyOf 1stringاختياري / عنصر
  • minLength: 1
  • maxLength: 160
post.media[].mime_typeanyOf 2nullاختياري / عنصر—
post.media[].preview_urlstring | nullاختياري / عنصر

URL قراءة مؤقت ومفوّض؛ احتفظ بـ url بوصفه هوية وسائط Scheduled Post المخزّنة.

—
post.media[].preview_urlanyOf 1stringاختياري / عنصر
  • format: "uri"
post.media[].preview_urlanyOf 2nullاختياري / عنصر—
post.media[].cover_preview_urlstring | nullاختياري / عنصر

URL قراءة مؤقت ومفوّض للغلاف؛ احتفظ بـ cover_url بوصفه هوية الوسائط المخزّنة.

—
post.media[].cover_preview_urlanyOf 1stringاختياري / عنصر
  • format: "uri"
post.media[].cover_preview_urlanyOf 2nullاختياري / عنصر—
post.media[].preview_expires_atstring | nullاختياري / عنصر—
post.media[].preview_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))$"
post.media[].preview_expires_atanyOf 2nullاختياري / عنصر—
post.link_urlstring | nullاختياري / عنصر—
post.link_urlanyOf 1stringاختياري / عنصر
  • format: "uri"
post.link_urlanyOf 2nullاختياري / عنصر—
post.publish_optionsobjectمطلوب في العنصر الأب—
post.publish_options.post_typestringاختياري / عنصر
  • enum: ["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]
post.publish_options.location_idstringاختياري / عنصر
  • minLength: 1
post.publish_options.share_to_feedbooleanاختياري / عنصر—
post.publish_options.collaboratorsarrayاختياري / عنصر
  • maxItems: 3
post.publish_options.collaborators[]stringاختياري / عنصر
  • minLength: 1
post.publish_options.first_commentstringاختياري / عنصر
  • minLength: 1
  • maxLength: 2200
post.publish_options.topic_tagstringاختياري / عنصر
  • minLength: 1
post.publish_options.thumb_offset_msintegerاختياري / عنصر
  • minimum: 0
  • maximum: 9007199254740991
post.publish_options.titlestringاختياري / عنصر
  • maxLength: 255
post.publish_options.youtube_privacy_statusstringاختياري / عنصر
  • enum: ["private","unlisted","public"]
post.publish_options.youtube_category_idstringاختياري / عنصر
  • pattern: "^\\d+$"
post.publish_options.youtube_contains_synthetic_mediabooleanاختياري / عنصر—
post.publish_options.descriptionstringاختياري / عنصر
  • maxLength: 5000
post.publish_options.category_idstringاختياري / عنصر
  • pattern: "^\\d+$"
post.publish_options.privacy_statusstringاختياري / عنصر
  • enum: ["private","unlisted","public"]
post.publish_options.cancellation_modestringاختياري / عنصر
  • enum: ["DELETE","UNSCHEDULE_KEEP_PRIVATE"]
post.publish_options.tagsarrayاختياري / عنصر—
post.publish_options.tags[]stringاختياري / عنصر—
post.publish_options.default_languagestringاختياري / عنصر—
post.publish_options.localizationsobjectاختياري / عنصر
  • additionalProperties: {}
post.publish_options.localizations.*any JSON valueاختياري / عنصر—
post.publish_options.licensestringاختياري / عنصر
  • enum: ["youtube","creativeCommon"]
post.publish_options.embeddablebooleanاختياري / عنصر—
post.publish_options.public_stats_viewablebooleanاختياري / عنصر—
post.publish_options.self_declared_made_for_kidsbooleanاختياري / عنصر—
post.publish_options.contains_synthetic_mediabooleanاختياري / عنصر—
post.publish_options.has_paid_product_placementbooleanاختياري / عنصر—
post.publish_options.recording_datestringاختياري / عنصر—
post.publish_options.notify_subscribersbooleanاختياري / عنصر—
post.publish_options.thumbnail_asset_idintegerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.publish_options.surface_expectationstringاختياري / عنصر
  • const: "SHORT"
post.publish_options.brand_partnerobjectاختياري / عنصر
  • additionalProperties: {}
post.publish_options.brand_partner.*any JSON valueاختياري / عنصر—
post.publish_options.cover_asset_idintegerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.publish_options.audio_namestringاختياري / عنصر—
post.publish_options.trial_paramsobjectاختياري / عنصر
  • additionalProperties: {}
post.publish_options.trial_params.*any JSON valueاختياري / عنصر—
post.publish_options.is_ai_generatedbooleanاختياري / عنصر—
post.publish_options.branded_content_sponsor_idsarrayاختياري / عنصر—
post.publish_options.branded_content_sponsor_ids[]stringاختياري / عنصر—
post.publish_options.is_paid_partnershipbooleanاختياري / عنصر—
post.publish_options.media_optionsarrayاختياري / عنصر—
post.publish_options.media_options[]objectاختياري / عنصر
  • additionalProperties: {}
post.publish_options.media_options[].*any JSON valueاختياري / عنصر—
post.publish_options.reply_to_idstringاختياري / عنصر—
post.publish_options.quote_post_idstringاختياري / عنصر—
post.publish_options.repost_target_idstringاختياري / عنصر—
post.publish_options.reply_controlstringاختياري / عنصر—
post.publish_options.enable_reply_approvalsbooleanاختياري / عنصر—
post.publish_options.link_attachmentstringاختياري / عنصر
  • format: "uri"
post.publish_options.poll_attachmentobjectاختياري / عنصر
  • additionalProperties: {}
post.publish_options.poll_attachment.*any JSON valueاختياري / عنصر—
post.publish_options.gif_attachmentobjectاختياري / عنصر
  • additionalProperties: {}
post.publish_options.gif_attachment.*any JSON valueاختياري / عنصر—
post.publish_options.text_attachmentobjectاختياري / عنصر
  • additionalProperties: {}
post.publish_options.text_attachment.*any JSON valueاختياري / عنصر—
post.publish_options.text_entitiesarrayاختياري / عنصر—
post.publish_options.text_entities[]objectاختياري / عنصر
  • additionalProperties: {}
post.publish_options.text_entities[].*any JSON valueاختياري / عنصر—
post.publish_options.is_spoiler_mediabooleanاختياري / عنصر—
post.publish_options.is_ghost_postbooleanاختياري / عنصر—
post.publish_options.allowlisted_country_codesarrayاختياري / عنصر—
post.publish_options.allowlisted_country_codes[]stringاختياري / عنصر—
post.publish_options.crossreshare_to_igbooleanاختياري / عنصر—
post.publish_options.crossreshare_to_ig_dark_modebooleanاختياري / عنصر—
post.publish_options.auto_publish_textbooleanاختياري / عنصر—
post.publish_options.publication_modestringاختياري / عنصر
  • enum: ["PUBLISH","DRAFT"]
post.publish_options.backdated_timenumberاختياري / عنصر—
post.publish_options.backdated_time_granularitystringاختياري / عنصر
  • enum: ["year","month","day","hour","minute"]
post.publish_options.placestringاختياري / عنصر—
post.publish_options.feed_targetingobjectاختياري / عنصر
  • additionalProperties: {}
post.publish_options.feed_targeting.*any JSON valueاختياري / عنصر—
post.publish_options.targetingobjectاختياري / عنصر
  • additionalProperties: {}
post.publish_options.targeting.*any JSON valueاختياري / عنصر—
post.publish_options.child_attachmentsarrayاختياري / عنصر—
post.publish_options.child_attachments[]objectاختياري / عنصر
  • additionalProperties: {}
post.publish_options.child_attachments[].*any JSON valueاختياري / عنصر—
post.publish_options.multi_share_end_cardbooleanاختياري / عنصر—
post.publish_options.multi_share_optimizedbooleanاختياري / عنصر—
post.publish_options.unpublished_content_typestringاختياري / عنصر—
post.publish_options.no_storybooleanاختياري / عنصر—
post.publish_options.crossposted_video_idstringاختياري / عنصر—
post.publish_options.sphericalbooleanاختياري / عنصر—
post.scheduled_atstringمطلوب في العنصر الأب—
post.display_timezonestringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 80
post.local_scheduled_atstring | nullاختياري / عنصر—
post.local_scheduled_atanyOf 1stringاختياري / عنصر
  • pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
post.local_scheduled_atanyOf 2nullاختياري / عنصر—
post.schedule_timezonestring | nullاختياري / عنصر—
post.schedule_timezoneanyOf 1stringاختياري / عنصر
  • minLength: 1
  • maxLength: 80
post.schedule_timezoneanyOf 2nullاختياري / عنصر—
post.schedule_dst_disambiguationstring | nullاختياري / عنصر—
post.schedule_dst_disambiguationanyOf 1stringاختياري / عنصر
  • enum: ["exact","earlier","later"]
post.schedule_dst_disambiguationanyOf 2nullاختياري / عنصر—
post.schedule_intent_statestringاختياري / عنصر
  • enum: ["verified","legacy_unverified"]
post.expires_atstring | nullمطلوب في العنصر الأب—
post.expires_atanyOf 1stringمطلوب في العنصر الأب—
post.expires_atanyOf 2nullمطلوب في العنصر الأب—
post.statusstringمطلوب في العنصر الأب
  • enum: ["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]
post.versionintegerمطلوب في العنصر الأب
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.automatic_retry_enabledbooleanمطلوب في العنصر الأب—
post.delete_requested_atstring | nullمطلوب في العنصر الأب—
post.delete_requested_atanyOf 1stringمطلوب في العنصر الأب—
post.delete_requested_atanyOf 2nullمطلوب في العنصر الأب—
post.published_atstring | nullمطلوب في العنصر الأب—
post.published_atanyOf 1stringمطلوب في العنصر الأب—
post.published_atanyOf 2nullمطلوب في العنصر الأب—
post.deleted_atstring | nullمطلوب في العنصر الأب—
post.deleted_atanyOf 1stringمطلوب في العنصر الأب—
post.deleted_atanyOf 2nullمطلوب في العنصر الأب—
post.provider_post_idstring | nullمطلوب في العنصر الأب—
post.provider_post_idanyOf 1stringمطلوب في العنصر الأب—
post.provider_post_idanyOf 2nullمطلوب في العنصر الأب—
post.permalinkstring | nullمطلوب في العنصر الأب—
post.permalinkanyOf 1stringمطلوب في العنصر الأب
  • format: "uri"
post.permalinkanyOf 2nullمطلوب في العنصر الأب—
post.created_atstringمطلوب في العنصر الأب—
post.updated_atstringمطلوب في العنصر الأب—
deliveryobjectمطلوب في العنصر الأب—
delivery.stagestringمطلوب في العنصر الأب
  • enum: ["scheduled","preparing","delivering","reconciling","cancelling","terminal"]
delivery.messagestringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 500
actionsarrayمطلوب في العنصر الأب
  • minItems: 5
  • maxItems: 5
actions[]objectاختياري / عنصر—
actions[].actionstringمطلوب في العنصر الأب
  • enum: ["edit","publish_now","retry","cancel","delete"]
actions[].allowedbooleanمطلوب في العنصر الأب—
actions[].reason_codestringمطلوب في العنصر الأب
  • enum: ["allowed","terminal_state","provider_preparation_started","delivery_started","not_scheduled","not_failed","retry_evidence_missing","destination_disconnected","expiry_passed","cancellation_in_progress","delete_in_progress","not_published"]
actions[].messagestringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 500
attemptsarrayمطلوب في العنصر الأب
  • maxItems: 200
attempts[]objectاختياري / عنصر—
attempts[].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)$"
attempts[].operationstringمطلوب في العنصر الأب
  • enum: ["publish","delete"]
attempts[].attempt_numberintegerمطلوب في العنصر الأب
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
attempts[].dispatched_atstringمطلوب في العنصر الأب—
outcomesarrayمطلوب في العنصر الأب
  • maxItems: 200
outcomes[]objectاختياري / عنصر—
outcomes[].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)$"
outcomes[].publication_attempt_idstring | nullمطلوب في العنصر الأب—
outcomes[].publication_attempt_idanyOf 1stringمطلوب في العنصر الأب
  • 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)$"
outcomes[].publication_attempt_idanyOf 2nullمطلوب في العنصر الأب—
outcomes[].operationstringمطلوب في العنصر الأب
  • enum: ["publish","delete"]
outcomes[].statusstringمطلوب في العنصر الأب
  • enum: ["published","failed","deleted"]
outcomes[].provider_post_idstring | nullمطلوب في العنصر الأب—
outcomes[].provider_post_idanyOf 1stringمطلوب في العنصر الأب—
outcomes[].provider_post_idanyOf 2nullمطلوب في العنصر الأب—
outcomes[].permalinkstring | nullمطلوب في العنصر الأب—
outcomes[].permalinkanyOf 1stringمطلوب في العنصر الأب
  • format: "uri"
outcomes[].permalinkanyOf 2nullمطلوب في العنصر الأب—
outcomes[].messagestringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 500
outcomes[].observed_atstringمطلوب في العنصر الأب—
outcomes[].terminal_suboperationobjectاختياري / عنصر—
outcomes[].terminal_suboperation.kindstringمطلوب في العنصر الأب
  • const: "instagram_first_comment"
outcomes[].terminal_suboperation.statusstringمطلوب في العنصر الأب
  • enum: ["succeeded","failed","attention"]
outcomes[].terminal_suboperation.external_idstring | nullمطلوب في العنصر الأب—
outcomes[].terminal_suboperation.external_idanyOf 1stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 500
outcomes[].terminal_suboperation.external_idanyOf 2nullمطلوب في العنصر الأب—
مخطط JSON Schema الكامل
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "post": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
        },
        "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)$"
        },
        "social_account_id": {
          "anyOf": [
            {
              "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)$"
            },
            {
              "type": "null"
            }
          ]
        },
        "platform": {
          "type": "string",
          "enum": [
            "instagram",
            "threads",
            "facebook",
            "youtube",
            "x"
          ]
        },
        "destination": {
          "type": "object",
          "properties": {
            "social_account_id": {
              "anyOf": [
                {
                  "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)$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "platform": {
              "type": "string",
              "enum": [
                "instagram",
                "threads",
                "facebook",
                "youtube",
                "x"
              ]
            },
            "platform_user_id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "account_label": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "social_account_id",
            "platform",
            "platform_user_id",
            "account_label"
          ]
        },
        "caption": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "hashtags": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "media": {
          "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"
                  }
                ]
              },
              "preview_url": {
                "description": "Temporary authorized read URL; keep url as persisted Scheduled Post media identity.",
                "anyOf": [
                  {
                    "type": "string",
                    "format": "uri"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "cover_preview_url": {
                "description": "Temporary authorized cover read URL; keep cover_url as persisted media identity.",
                "anyOf": [
                  {
                    "type": "string",
                    "format": "uri"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "preview_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))$"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "kind",
              "url"
            ]
          }
        },
        "link_url": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "publish_options": {
          "type": "object",
          "properties": {
            "post_type": {
              "type": "string",
              "enum": [
                "TEXT",
                "LINK",
                "IMAGE",
                "MULTI_IMAGE",
                "VIDEO",
                "CAROUSEL",
                "REELS",
                "STORY_IMAGE",
                "STORY_VIDEO",
                "REPOST",
                "SHORT"
              ]
            },
            "location_id": {
              "type": "string",
              "minLength": 1
            },
            "share_to_feed": {
              "type": "boolean"
            },
            "collaborators": {
              "maxItems": 3,
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1
              }
            },
            "first_comment": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2200
            },
            "topic_tag": {
              "type": "string",
              "minLength": 1
            },
            "thumb_offset_ms": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "title": {
              "type": "string",
              "maxLength": 255
            },
            "youtube_privacy_status": {
              "type": "string",
              "enum": [
                "private",
                "unlisted",
                "public"
              ]
            },
            "youtube_category_id": {
              "type": "string",
              "pattern": "^\\d+$"
            },
            "youtube_contains_synthetic_media": {
              "type": "boolean"
            },
            "description": {
              "type": "string",
              "maxLength": 5000
            },
            "category_id": {
              "type": "string",
              "pattern": "^\\d+$"
            },
            "privacy_status": {
              "type": "string",
              "enum": [
                "private",
                "unlisted",
                "public"
              ]
            },
            "cancellation_mode": {
              "type": "string",
              "enum": [
                "DELETE",
                "UNSCHEDULE_KEEP_PRIVATE"
              ]
            },
            "tags": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "default_language": {
              "type": "string"
            },
            "localizations": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "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"
            },
            "notify_subscribers": {
              "type": "boolean"
            },
            "thumbnail_asset_id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            "surface_expectation": {
              "type": "string",
              "const": "SHORT"
            },
            "brand_partner": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "cover_asset_id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            "audio_name": {
              "type": "string"
            },
            "trial_params": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "is_ai_generated": {
              "type": "boolean"
            },
            "branded_content_sponsor_ids": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "is_paid_partnership": {
              "type": "boolean"
            },
            "media_options": {
              "type": "array",
              "items": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              }
            },
            "reply_to_id": {
              "type": "string"
            },
            "quote_post_id": {
              "type": "string"
            },
            "repost_target_id": {
              "type": "string"
            },
            "reply_control": {
              "type": "string"
            },
            "enable_reply_approvals": {
              "type": "boolean"
            },
            "link_attachment": {
              "type": "string",
              "format": "uri"
            },
            "poll_attachment": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "gif_attachment": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "text_attachment": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "text_entities": {
              "type": "array",
              "items": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              }
            },
            "is_spoiler_media": {
              "type": "boolean"
            },
            "is_ghost_post": {
              "type": "boolean"
            },
            "allowlisted_country_codes": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "crossreshare_to_ig": {
              "type": "boolean"
            },
            "crossreshare_to_ig_dark_mode": {
              "type": "boolean"
            },
            "auto_publish_text": {
              "type": "boolean"
            },
            "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"
            },
            "feed_targeting": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "targeting": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "child_attachments": {
              "type": "array",
              "items": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              }
            },
            "multi_share_end_card": {
              "type": "boolean"
            },
            "multi_share_optimized": {
              "type": "boolean"
            },
            "unpublished_content_type": {
              "type": "string"
            },
            "no_story": {
              "type": "boolean"
            },
            "crossposted_video_id": {
              "type": "string"
            },
            "spherical": {
              "type": "boolean"
            }
          }
        },
        "scheduled_at": {
          "type": "string"
        },
        "display_timezone": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        "local_scheduled_at": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
            },
            {
              "type": "null"
            }
          ]
        },
        "schedule_timezone": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1,
              "maxLength": 80
            },
            {
              "type": "null"
            }
          ]
        },
        "schedule_dst_disambiguation": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "exact",
                "earlier",
                "later"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "schedule_intent_state": {
          "type": "string",
          "enum": [
            "verified",
            "legacy_unverified"
          ]
        },
        "expires_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "status": {
          "type": "string",
          "enum": [
            "scheduled",
            "publishing",
            "published",
            "failed",
            "expired",
            "needs_reschedule",
            "cancelled",
            "deleted"
          ]
        },
        "version": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        "automatic_retry_enabled": {
          "type": "boolean"
        },
        "delete_requested_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "published_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "deleted_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "provider_post_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "permalink": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "created_at": {
          "type": "string"
        },
        "updated_at": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "workspace_id",
        "social_account_id",
        "platform",
        "destination",
        "caption",
        "hashtags",
        "media",
        "publish_options",
        "scheduled_at",
        "display_timezone",
        "expires_at",
        "status",
        "version",
        "automatic_retry_enabled",
        "delete_requested_at",
        "published_at",
        "deleted_at",
        "provider_post_id",
        "permalink",
        "created_at",
        "updated_at"
      ]
    },
    "delivery": {
      "type": "object",
      "properties": {
        "stage": {
          "type": "string",
          "enum": [
            "scheduled",
            "preparing",
            "delivering",
            "reconciling",
            "cancelling",
            "terminal"
          ]
        },
        "message": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500
        }
      },
      "required": [
        "stage",
        "message"
      ]
    },
    "actions": {
      "minItems": 5,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "edit",
              "publish_now",
              "retry",
              "cancel",
              "delete"
            ]
          },
          "allowed": {
            "type": "boolean"
          },
          "reason_code": {
            "type": "string",
            "enum": [
              "allowed",
              "terminal_state",
              "provider_preparation_started",
              "delivery_started",
              "not_scheduled",
              "not_failed",
              "retry_evidence_missing",
              "destination_disconnected",
              "expiry_passed",
              "cancellation_in_progress",
              "delete_in_progress",
              "not_published"
            ]
          },
          "message": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          }
        },
        "required": [
          "action",
          "allowed",
          "reason_code",
          "message"
        ]
      }
    },
    "attempts": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "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)$"
          },
          "operation": {
            "type": "string",
            "enum": [
              "publish",
              "delete"
            ]
          },
          "attempt_number": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "dispatched_at": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "operation",
          "attempt_number",
          "dispatched_at"
        ]
      }
    },
    "outcomes": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "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)$"
          },
          "publication_attempt_id": {
            "anyOf": [
              {
                "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)$"
              },
              {
                "type": "null"
              }
            ]
          },
          "operation": {
            "type": "string",
            "enum": [
              "publish",
              "delete"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "published",
              "failed",
              "deleted"
            ]
          },
          "provider_post_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "permalink": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          },
          "message": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "observed_at": {
            "type": "string"
          },
          "terminal_suboperation": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "instagram_first_comment"
              },
              "status": {
                "type": "string",
                "enum": [
                  "succeeded",
                  "failed",
                  "attention"
                ]
              },
              "external_id": {
                "anyOf": [
                  {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "kind",
              "status",
              "external_id"
            ]
          }
        },
        "required": [
          "id",
          "publication_attempt_id",
          "operation",
          "status",
          "provider_post_id",
          "permalink",
          "message",
          "observed_at"
        ]
      }
    }
  },
  "required": [
    "post",
    "delivery",
    "actions",
    "attempts",
    "outcomes"
  ]
}

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

افحص حالة 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

{
  "id": "11111111-1111-4111-8111-111111111111"
}

cURL

curl --request POST \
  "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/get" \
  -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/get", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
  body: JSON.stringify({
  "id": "11111111-1111-4111-8111-111111111111"
})
});
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/get < request.json

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

{
  "post": {
    "id": "11111111-1111-4111-8111-111111111111",
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "social_account_id": null,
    "platform": "instagram",
    "destination": {
      "social_account_id": null,
      "platform": "instagram",
      "platform_user_id": null,
      "account_label": null
    },
    "caption": null,
    "hashtags": [],
    "media": [],
    "publish_options": {},
    "scheduled_at": "example",
    "display_timezone": "UTC",
    "expires_at": null,
    "status": "scheduled",
    "version": 1,
    "automatic_retry_enabled": false,
    "delete_requested_at": null,
    "published_at": null,
    "deleted_at": null,
    "provider_post_id": null,
    "permalink": null,
    "created_at": "example",
    "updated_at": "example"
  },
  "delivery": {
    "stage": "scheduled",
    "message": "example"
  },
  "actions": [
    {
      "action": "edit",
      "allowed": true,
      "reason_code": "allowed",
      "message": "Allowed in this example state."
    },
    {
      "action": "publish_now",
      "allowed": true,
      "reason_code": "allowed",
      "message": "Allowed in this example state."
    },
    {
      "action": "retry",
      "allowed": false,
      "reason_code": "not_failed",
      "message": "This example post has not failed."
    },
    {
      "action": "cancel",
      "allowed": true,
      "reason_code": "allowed",
      "message": "Allowed in this example state."
    },
    {
      "action": "delete",
      "allowed": true,
      "reason_code": "allowed",
      "message": "Allowed in this example state."
    }
  ],
  "attempts": [],
  "outcomes": []
}

MCP: sosoapi_get_scheduled_post

جميع عمليات APIالمصادقة والأذونات