الجدولة والنشر
إرسال مسودة مساحة العمل
استخدمه فقط بعد قرار صريح بالنشر. يتطلب دور editor أو أعلى وإمكانية publish. أرسل أولاً id وexpected_revision وmutation_id وcontent وطلب النشر المعتمد request؛ واحذف source_ref لأن الخادم يدير مصدر المحتوى وهويات الإرسال. محتوى المحررين المشاركين غير موثوق. لا يقبل رد 422 مع state=draft أي وجهة: أصلح المحتوى قبل إجراء طفرة جديدة. بعد البدء، استخدم GET للمسودة نفسها، وتابع النتيجة المجهولة أو الجزئية باستخدام submission.id بوصفه mutation_id وsubmission.expected_revision، مع حذف كل من content وrequest. لا تنشئ أبداً منشورات بديلة ولا تعِد إنشاء Posts المقبولة. تعني submitted التسليم إلى Scheduled Publishing؛ اقرأ Post الأصلي لمعرفة نتيجة المزوّد.
POST /studio-api/content-drafts/submitمراجعة العقد: · sha256:75c8b8ebce408575
نظرة عامة
استخدمه فقط بعد قرار صريح بالنشر. يتطلب دور editor أو أعلى وإمكانية publish. أرسل أولاً id وexpected_revision وmutation_id وcontent وطلب النشر المعتمد request؛ واحذف source_ref لأن الخادم يدير مصدر المحتوى وهويات الإرسال. محتوى المحررين المشاركين غير موثوق. لا يقبل رد 422 مع state=draft أي وجهة: أصلح المحتوى قبل إجراء طفرة جديدة. بعد البدء، استخدم GET للمسودة نفسها، وتابع النتيجة المجهولة أو الجزئية باستخدام submission.id بوصفه mutation_id وsubmission.expected_revision، مع حذف كل من content وrequest. لا تنشئ أبداً منشورات بديلة ولا تعِد إنشاء Posts المقبولة. تعني submitted التسليم إلى Scheduled Publishing؛ اقرأ Post الأصلي لمعرفة نتيجة المزوّد.
قد يعني نجاح HTTP قبول الطلب لا اكتماله. للعمل الخلفي، احفظ المعرّف المُعاد وتابع العملية نفسها حتى تنتهي. لا يُعدّ المنشور المجدول أوالمقبول منشوراً حتى تأكيد المنصة؛ انتهاء مهلة العميل لا يثبت النتيجة.
المصادقة والأذونات
لا يستخدم الرمز إلا حقوق مالكه. يفحص كل طلب عضوية مساحة العمل وملكية المورد والمساحات المحددة والإمكانات الممنوحة. يغيّر core و full الأدوات المعروضة؛ ولا يمنحان وصولاً.
حقول الطلب
تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.
| الحقل / الفرع | النوع / مطلوب | القيود |
|---|---|---|
$ | objectمطلوب في العنصر الأب |
|
id | stringمطلوب في العنصر الأب |
|
expected_revision | integerمطلوب في العنصر الأب |
|
mutation_id | stringمطلوب في العنصر الأب |
|
content | objectاختياري / عنصر |
|
content.schemaVersion | numberاختياري / عنصر |
|
content.accountIds | arrayاختياري / عنصر |
|
content.accountIds[] | stringاختياري / عنصر |
|
content.caption | stringاختياري / عنصر |
|
content.hashtags | stringاختياري / عنصر |
|
content.assetIds | arrayاختياري / عنصر |
|
content.assetIds[] | stringاختياري / عنصر |
|
content.threadsTextOnly | booleanاختياري / عنصر |
|
content.instagramMode | stringاختياري / عنصر |
|
content.youtubeTitle | stringاختياري / عنصر |
|
content.youtubePrivacy | stringاختياري / عنصر |
|
content.youtubeSynthetic | booleanاختياري / عنصر |
|
content.youtubeCategoryId | stringاختياري / عنصر |
|
content.youtubeShort | booleanاختياري / عنصر |
|
content.linkUrl | stringاختياري / عنصر |
|
content.scheduledAt | stringاختياري / عنصر |
|
content.displayTimezone | stringاختياري / عنصر |
|
content.publishNow | booleanاختياري / عنصر |
|
content.destinationOverrides | objectاختياري / عنصر |
|
content.destinationOverrides.* | objectاختياري / عنصر |
|
content.destinationOverrides.*.caption | stringاختياري / عنصر |
|
content.destinationOverrides.*.scheduledAt | stringاختياري / عنصر |
|
content.expiresAt | stringاختياري / عنصر |
|
request | objectاختياري / عنصر |
|
request.workspace_id | stringمطلوب في العنصر الأب |
|
request.project_id | string | nullاختياري / عنصر | — |
request.project_idanyOf 1 | stringاختياري / عنصر |
|
request.project_idanyOf 2 | nullاختياري / عنصر | — |
request.source_ref | object | nullاختياري / عنصر | — |
request.source_refanyOf 1 | objectاختياري / عنصر |
|
request.source_ref.*anyOf 1 | any JSON valueاختياري / عنصر | — |
request.source_refanyOf 2 | nullاختياري / عنصر | — |
request.targets | arrayمطلوب في العنصر الأب |
|
request.targets[] | objectاختياري / عنصر |
|
request.targets[].social_account_id | stringمطلوب في العنصر الأب |
|
request.targets[].caption | string | nullاختياري / عنصر |
|
request.targets[].captionanyOf 1 | stringاختياري / عنصر |
|
request.targets[].captionanyOf 2 | nullاختياري / عنصر | — |
request.targets[].hashtags | arrayاختياري / عنصر |
|
request.targets[].hashtags[] | stringاختياري / عنصر |
|
request.targets[].media | arrayاختياري / عنصر |
|
request.targets[].media[] | objectاختياري / عنصر |
|
request.targets[].media[].kind | stringمطلوب في العنصر الأب |
|
request.targets[].media[].url | stringمطلوب في العنصر الأب |
|
request.targets[].media[].cover_url | string | nullاختياري / عنصر | — |
request.targets[].media[].cover_urlanyOf 1 | stringاختياري / عنصر |
|
request.targets[].media[].cover_urlanyOf 2 | nullاختياري / عنصر | — |
request.targets[].media[].cover_asset_id | integer | nullاختياري / عنصر | — |
request.targets[].media[].cover_asset_idanyOf 1 | integerاختياري / عنصر |
|
request.targets[].media[].cover_asset_idanyOf 2 | nullاختياري / عنصر | — |
request.targets[].media[].asset_id | integer | nullاختياري / عنصر | — |
request.targets[].media[].asset_idanyOf 1 | integerاختياري / عنصر |
|
request.targets[].media[].asset_idanyOf 2 | nullاختياري / عنصر | — |
request.targets[].media[].mime_type | string | nullاختياري / عنصر | — |
request.targets[].media[].mime_typeanyOf 1 | stringاختياري / عنصر |
|
request.targets[].media[].mime_typeanyOf 2 | nullاختياري / عنصر | — |
request.targets[].link_url | string | nullاختياري / عنصر | — |
request.targets[].link_urlanyOf 1 | stringاختياري / عنصر |
|
request.targets[].link_urlanyOf 2 | nullاختياري / عنصر | — |
request.targets[].provider_payload | objectمطلوب في العنصر الأب | — |
request.targets[].provider_payloadoneOf 1 | objectمطلوب في العنصر الأب |
|
request.targets[].provider_payload.platformoneOf 1 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_optionsoneOf 1 | objectمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 1 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payloadoneOf 2 | objectمطلوب في العنصر الأب |
|
request.targets[].provider_payload.platformoneOf 2 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_optionsoneOf 2 | objectمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 2 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.location_idoneOf 2 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.share_to_feedoneOf 2 | booleanاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.collaboratorsoneOf 2 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.collaborators[]oneOf 2 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.first_commentoneOf 2 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.cover_asset_idoneOf 2 | integerاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.thumb_offset_msoneOf 2 | integerاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.audio_nameoneOf 2 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.trial_paramsoneOf 2 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.trial_params.graduation_strategyoneOf 2 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.is_ai_generatedoneOf 2 | booleanاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.branded_content_sponsor_idsoneOf 2 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.branded_content_sponsor_ids[]oneOf 2 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.is_paid_partnershiponeOf 2 | booleanاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.media_optionsoneOf 2 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.media_options[]oneOf 2 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.media_options[].asset_idoneOf 2 | integerمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.media_options[].alt_textoneOf 2 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.media_options[].user_tagsoneOf 2 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[]oneOf 2 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[].usernameoneOf 2 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[].xoneOf 2 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[].yoneOf 2 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.media_options[].product_tagsoneOf 2 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[]oneOf 2 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[].product_idoneOf 2 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[].xoneOf 2 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[].yoneOf 2 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.media_options[].thumb_offset_msoneOf 2 | integerاختياري / عنصر |
|
request.targets[].provider_payloadoneOf 3 | objectمطلوب في العنصر الأب |
|
request.targets[].provider_payload.platformoneOf 3 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_optionsoneOf 3 | objectمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 3 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.titleoneOf 3 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.descriptiononeOf 3 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.publication_modeoneOf 3 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.backdated_timeoneOf 3 | numberاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.backdated_time_granularityoneOf 3 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.placeoneOf 3 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.tagsoneOf 3 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.tags[]oneOf 3 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targetingoneOf 3 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.age_minoneOf 3 | integerاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.age_maxoneOf 3 | integerاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.college_yearsoneOf 3 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.college_years[]oneOf 3 | integerاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statusesoneOf 3 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 | numberاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 1 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 2 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 3 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.gendersoneOf 3 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3 | numberاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3 / anyOf 1 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3 / anyOf 2 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locationsoneOf 3 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.countriesoneOf 3 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.countries[]oneOf 3 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regionsoneOf 3 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[]oneOf 3 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 | string | integerمطلوب في العنصر الأب | — |
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 / anyOf 1 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 / anyOf 2 | integerمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.citiesoneOf 3 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[]oneOf 3 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 | string | integerمطلوب في العنصر الأب | — |
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 / anyOf 1 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 / anyOf 2 | integerمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].radiusoneOf 3 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].distance_unitoneOf 3 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zipsoneOf 3 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[]oneOf 3 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 | string | integerمطلوب في العنصر الأب | — |
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 / anyOf 1 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 / anyOf 2 | integerمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.location_typesoneOf 3 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.location_types[]oneOf 3 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.interestsoneOf 3 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3 | string | integerاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3 / anyOf 1 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3 / anyOf 2 | integerاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.localesoneOf 3 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.locales[]oneOf 3 | integerاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statusesoneOf 3 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 | numberاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 1 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 2 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 3 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 4 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.targetingoneOf 3 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 | numberاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 1 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 2 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 3 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 4 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 5 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.targeting.geo_locationsoneOf 3 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.countriesoneOf 3 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.countries[]oneOf 3 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regionsoneOf 3 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[]oneOf 3 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 | string | integerمطلوب في العنصر الأب | — |
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 / anyOf 1 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 / anyOf 2 | integerمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.citiesoneOf 3 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[]oneOf 3 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 | string | integerمطلوب في العنصر الأب | — |
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 / anyOf 1 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 / anyOf 2 | integerمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].radiusoneOf 3 | numberاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].distance_unitoneOf 3 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zipsoneOf 3 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[]oneOf 3 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 | string | integerمطلوب في العنصر الأب | — |
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 / anyOf 1 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 / anyOf 2 | integerمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.location_typesoneOf 3 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.location_types[]oneOf 3 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.child_attachmentsoneOf 3 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.child_attachments[]oneOf 3 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.child_attachments[].linkoneOf 3 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.child_attachments[].nameoneOf 3 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.child_attachments[].descriptiononeOf 3 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.child_attachments[].pictureoneOf 3 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.multi_share_end_cardoneOf 3 | booleanاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.multi_share_optimizedoneOf 3 | booleanاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.unpublished_content_typeoneOf 3 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.no_storyoneOf 3 | booleanاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.crossposted_video_idoneOf 3 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.sphericaloneOf 3 | booleanاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.media_optionsoneOf 3 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.media_options[]oneOf 3 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.media_options[].asset_idoneOf 3 | integerمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.media_options[].alt_text_customoneOf 3 | stringاختياري / عنصر |
|
request.targets[].provider_payloadoneOf 4 | objectمطلوب في العنصر الأب |
|
request.targets[].provider_payload.platformoneOf 4 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_optionsoneOf 4 | objectمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 4 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.reply_to_idoneOf 4 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.quote_post_idoneOf 4 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.repost_target_idoneOf 4 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.reply_controloneOf 4 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.enable_reply_approvalsoneOf 4 | booleanاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.link_attachmentoneOf 4 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.poll_attachmentoneOf 4 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_aoneOf 4 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_boneOf 4 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_coneOf 4 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_doneOf 4 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.gif_attachmentoneOf 4 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.gif_attachment.gif_idoneOf 4 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.gif_attachment.provideroneOf 4 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.text_attachmentoneOf 4 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.text_attachment.plaintextoneOf 4 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.text_attachment.link_attachment_urloneOf 4 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_infooneOf 4 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[]oneOf 4 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].offsetoneOf 4 | integerمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].lengthoneOf 4 | integerمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_infooneOf 4 | arrayمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_info[]oneOf 4 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.topic_tagoneOf 4 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.text_entitiesoneOf 4 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.text_entities[]oneOf 4 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.text_entities[].entity_typeoneOf 4 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.text_entities[].offsetoneOf 4 | integerمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.text_entities[].lengthoneOf 4 | integerمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.is_spoiler_mediaoneOf 4 | booleanاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.is_ghost_postoneOf 4 | booleanاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.location_idoneOf 4 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.allowlisted_country_codesoneOf 4 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.allowlisted_country_codes[]oneOf 4 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.crossreshare_to_igoneOf 4 | booleanاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.crossreshare_to_ig_dark_modeoneOf 4 | booleanاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.auto_publish_textoneOf 4 | booleanاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.media_optionsoneOf 4 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.media_options[]oneOf 4 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.media_options[].asset_idoneOf 4 | integerمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.media_options[].alt_textoneOf 4 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.media_options[].is_spoiler_mediaoneOf 4 | booleanاختياري / عنصر | — |
request.targets[].provider_payloadoneOf 5 | objectمطلوب في العنصر الأب |
|
request.targets[].provider_payload.platformoneOf 5 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_optionsoneOf 5 | objectمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 5 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.titleoneOf 5 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.descriptiononeOf 5 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.tagsoneOf 5 | arrayاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.tags[]oneOf 5 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.category_idoneOf 5 | stringاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.category_idoneOf 5 / anyOf 1 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.category_idoneOf 5 / anyOf 2 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.default_languageoneOf 5 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.localizationsoneOf 5 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.localizations.*oneOf 5 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.localizations.*.titleoneOf 5 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.localizations.*.descriptiononeOf 5 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.privacy_statusoneOf 5 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.cancellation_modeoneOf 5 | stringمطلوب في العنصر الأب |
|
request.targets[].provider_payload.publish_options.licenseoneOf 5 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.embeddableoneOf 5 | booleanاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.public_stats_viewableoneOf 5 | booleanاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.self_declared_made_for_kidsoneOf 5 | booleanاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.contains_synthetic_mediaoneOf 5 | booleanاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.has_paid_product_placementoneOf 5 | booleanاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.recording_dateoneOf 5 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.notify_subscribersoneOf 5 | booleanاختياري / عنصر | — |
request.targets[].provider_payload.publish_options.thumbnail_asset_idoneOf 5 | integerاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.surface_expectationoneOf 5 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.brand_partneroneOf 5 | objectاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.brand_partner.channel_idoneOf 5 | stringاختياري / عنصر |
|
request.targets[].provider_payload.publish_options.brand_partner.channel_handleoneOf 5 | stringاختياري / عنصر |
|
request.targets[].scheduled_at | stringمطلوب في العنصر الأب |
|
request.targets[].display_timezone | stringاختياري / عنصر |
|
request.targets[].local_scheduled_at | stringاختياري / عنصر |
|
request.targets[].schedule_dst_disambiguation | stringاختياري / عنصر |
|
request.targets[].expires_at | string | nullاختياري / عنصر | — |
request.targets[].expires_atanyOf 1 | stringاختياري / عنصر |
|
request.targets[].expires_atanyOf 2 | nullاختياري / عنصر | — |
request.targets[].source_ref | object | nullاختياري / عنصر | — |
request.targets[].source_refanyOf 1 | objectاختياري / عنصر |
|
request.targets[].source_ref.*anyOf 1 | any JSON valueاختياري / عنصر | — |
request.targets[].source_refanyOf 2 | nullاختياري / عنصر | — |
request.targets[].automatic_retry_enabled | booleanاختياري / عنصر |
|
request.targets[].idempotency_key | stringمطلوب في العنصر الأب |
|
مخطط JSON Schema الكامل
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"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)$"
},
"expected_revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"mutation_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)$"
},
"content": {
"type": "object",
"properties": {
"schemaVersion": {
"default": 1,
"type": "number",
"const": 1
},
"accountIds": {
"default": [],
"maxItems": 50,
"type": "array",
"items": {
"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)$"
}
},
"caption": {
"default": "",
"type": "string",
"maxLength": 5000
},
"hashtags": {
"default": "",
"type": "string",
"maxLength": 5000
},
"assetIds": {
"default": [],
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"maxLength": 16,
"pattern": "^[1-9][0-9]*$"
}
},
"threadsTextOnly": {
"default": false,
"type": "boolean"
},
"instagramMode": {
"default": "REELS",
"type": "string",
"enum": [
"IMAGE",
"REELS",
"CAROUSEL",
"STORY_IMAGE",
"STORY_VIDEO"
]
},
"youtubeTitle": {
"default": "",
"type": "string",
"maxLength": 100
},
"youtubePrivacy": {
"default": "private",
"type": "string",
"enum": [
"private",
"unlisted",
"public"
]
},
"youtubeSynthetic": {
"default": false,
"type": "boolean"
},
"youtubeCategoryId": {
"default": "",
"type": "string",
"maxLength": 32
},
"youtubeShort": {
"default": false,
"type": "boolean"
},
"linkUrl": {
"default": "",
"type": "string",
"maxLength": 2048
},
"scheduledAt": {
"default": "",
"type": "string",
"maxLength": 64
},
"displayTimezone": {
"default": "UTC",
"type": "string",
"minLength": 1,
"maxLength": 128
},
"publishNow": {
"default": false,
"type": "boolean"
},
"destinationOverrides": {
"default": {},
"type": "object",
"propertyNames": {
"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)$"
},
"additionalProperties": {
"type": "object",
"properties": {
"caption": {
"type": "string",
"maxLength": 5000
},
"scheduledAt": {
"type": "string",
"maxLength": 64
}
},
"additionalProperties": false
}
},
"expiresAt": {
"default": "",
"type": "string",
"maxLength": 64
}
},
"additionalProperties": false
},
"request": {
"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)$"
},
"project_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"
}
]
},
"source_ref": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"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)$"
},
"caption": {
"default": null,
"anyOf": [
{
"type": "string",
"maxLength": 5000
},
{
"type": "null"
}
]
},
"hashtags": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"maxLength": 100
}
},
"media": {
"default": [],
"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",
"enum": [
"TEXT",
"VIDEO"
]
}
},
"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
}
]
},
"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": {
"default": "UTC",
"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"
}
]
},
"source_ref": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"automatic_retry_enabled": {
"default": true,
"type": "boolean"
},
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 160
}
},
"required": [
"social_account_id",
"provider_payload",
"scheduled_at",
"idempotency_key"
],
"additionalProperties": false
}
}
},
"required": [
"workspace_id",
"targets"
],
"additionalProperties": false
}
},
"required": [
"id",
"expected_revision",
"mutation_id"
],
"additionalProperties": false
}الاستجابة والاكتمال
رموز نجاح HTTP: 200, 422. متى تُعدّ العملية مكتملة: durable destination acceptance; provider publication is separate.
قد يعني نجاح HTTP قبول الطلب لا اكتماله. للعمل الخلفي، احفظ المعرّف المُعاد وتابع العملية نفسها حتى تنتهي. لا يُعدّ المنشور المجدول أوالمقبول منشوراً حتى تأكيد المنصة؛ انتهاء مهلة العميل لا يثبت النتيجة.
تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.
| الحقل / الفرع | النوع / مطلوب | القيود |
|---|---|---|
$ | objectمطلوب في العنصر الأب | — |
draft | objectمطلوب في العنصر الأب | — |
draft.id | stringمطلوب في العنصر الأب |
|
draft.workspace_id | stringمطلوب في العنصر الأب |
|
draft.revision | integerمطلوب في العنصر الأب |
|
draft.state | stringمطلوب في العنصر الأب |
|
draft.content | objectمطلوب في العنصر الأب | — |
draft.content.schemaVersion | numberمطلوب في العنصر الأب |
|
draft.content.accountIds | arrayمطلوب في العنصر الأب |
|
draft.content.accountIds[] | stringاختياري / عنصر |
|
draft.content.caption | stringمطلوب في العنصر الأب |
|
draft.content.hashtags | stringمطلوب في العنصر الأب |
|
draft.content.assetIds | arrayمطلوب في العنصر الأب |
|
draft.content.assetIds[] | stringاختياري / عنصر |
|
draft.content.threadsTextOnly | booleanمطلوب في العنصر الأب |
|
draft.content.instagramMode | stringمطلوب في العنصر الأب |
|
draft.content.youtubeTitle | stringمطلوب في العنصر الأب |
|
draft.content.youtubePrivacy | stringمطلوب في العنصر الأب |
|
draft.content.youtubeSynthetic | booleanمطلوب في العنصر الأب |
|
draft.content.youtubeCategoryId | stringمطلوب في العنصر الأب |
|
draft.content.youtubeShort | booleanمطلوب في العنصر الأب |
|
draft.content.linkUrl | stringمطلوب في العنصر الأب |
|
draft.content.scheduledAt | stringمطلوب في العنصر الأب |
|
draft.content.displayTimezone | stringمطلوب في العنصر الأب |
|
draft.content.publishNow | booleanمطلوب في العنصر الأب |
|
draft.content.destinationOverrides | objectمطلوب في العنصر الأب |
|
draft.content.destinationOverrides.* | objectاختياري / عنصر | — |
draft.content.destinationOverrides.*.caption | stringاختياري / عنصر |
|
draft.content.destinationOverrides.*.scheduledAt | stringاختياري / عنصر |
|
draft.content.expiresAt | stringمطلوب في العنصر الأب |
|
draft.created_by | string | nullمطلوب في العنصر الأب | — |
draft.created_byanyOf 1 | stringمطلوب في العنصر الأب |
|
draft.created_byanyOf 2 | nullمطلوب في العنصر الأب | — |
draft.updated_by | string | nullمطلوب في العنصر الأب | — |
draft.updated_byanyOf 1 | stringمطلوب في العنصر الأب |
|
draft.updated_byanyOf 2 | nullمطلوب في العنصر الأب | — |
draft.created_at | stringمطلوب في العنصر الأب |
|
draft.updated_at | stringمطلوب في العنصر الأب |
|
draft.submission | object | nullمطلوب في العنصر الأب | — |
draft.submissionanyOf 1 | objectمطلوب في العنصر الأب | — |
draft.submission.idanyOf 1 | stringمطلوب في العنصر الأب |
|
draft.submission.expected_revisionanyOf 1 | integerمطلوب في العنصر الأب |
|
draft.submission.started_atanyOf 1 | stringمطلوب في العنصر الأب |
|
draft.submission.receiptanyOf 1 | object | nullمطلوب في العنصر الأب | — |
draft.submission.receiptanyOf 1 / anyOf 1 | objectمطلوب في العنصر الأب | — |
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 | string | nullمطلوب في العنصر الأب | — |
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
draft.submission.receipt.successesanyOf 1 / anyOf 1 | arrayمطلوب في العنصر الأب |
|
draft.submission.receipt.successes[]anyOf 1 / anyOf 1 | objectاختياري / عنصر | — |
draft.submission.receipt.successes[].social_account_idanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
draft.submission.receipt.successes[].post_idanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
draft.submission.receipt.failuresanyOf 1 / anyOf 1 | arrayمطلوب في العنصر الأب |
|
draft.submission.receipt.failures[]anyOf 1 / anyOf 1 | objectاختياري / عنصر | — |
draft.submission.receipt.failures[].social_account_idanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
draft.submission.receipt.failures[].codeanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
draft.submission.receipt.failures[].messageanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
draft.submission.receiptanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
draft.submissionanyOf 2 | nullمطلوب في العنصر الأب | — |
result | objectمطلوب في العنصر الأب | — |
result.batch_id | string | nullمطلوب في العنصر الأب | — |
result.batch_idanyOf 1 | stringمطلوب في العنصر الأب |
|
result.batch_idanyOf 2 | nullمطلوب في العنصر الأب | — |
result.successes | arrayمطلوب في العنصر الأب | — |
result.successes[] | objectاختياري / عنصر | — |
result.successes[].social_account_id | stringمطلوب في العنصر الأب |
|
result.successes[].post | objectمطلوب في العنصر الأب | — |
result.successes[].post.id | stringمطلوب في العنصر الأب |
|
result.successes[].post.workspace_id | stringمطلوب في العنصر الأب |
|
result.successes[].post.social_account_id | string | nullمطلوب في العنصر الأب | — |
result.successes[].post.social_account_idanyOf 1 | stringمطلوب في العنصر الأب |
|
result.successes[].post.social_account_idanyOf 2 | nullمطلوب في العنصر الأب | — |
result.successes[].post.platform | stringمطلوب في العنصر الأب |
|
result.successes[].post.destination | objectمطلوب في العنصر الأب | — |
result.successes[].post.destination.social_account_id | string | nullمطلوب في العنصر الأب | — |
result.successes[].post.destination.social_account_idanyOf 1 | stringمطلوب في العنصر الأب |
|
result.successes[].post.destination.social_account_idanyOf 2 | nullمطلوب في العنصر الأب | — |
result.successes[].post.destination.platform | stringمطلوب في العنصر الأب |
|
result.successes[].post.destination.platform_user_id | string | nullمطلوب في العنصر الأب | — |
result.successes[].post.destination.platform_user_idanyOf 1 | stringمطلوب في العنصر الأب | — |
result.successes[].post.destination.platform_user_idanyOf 2 | nullمطلوب في العنصر الأب | — |
result.successes[].post.destination.account_label | string | nullمطلوب في العنصر الأب | — |
result.successes[].post.destination.account_labelanyOf 1 | stringمطلوب في العنصر الأب | — |
result.successes[].post.destination.account_labelanyOf 2 | nullمطلوب في العنصر الأب | — |
result.successes[].post.caption | string | nullمطلوب في العنصر الأب | — |
result.successes[].post.captionanyOf 1 | stringمطلوب في العنصر الأب | — |
result.successes[].post.captionanyOf 2 | nullمطلوب في العنصر الأب | — |
result.successes[].post.hashtags | arrayمطلوب في العنصر الأب | — |
result.successes[].post.hashtags[] | stringاختياري / عنصر | — |
result.successes[].post.media | arrayمطلوب في العنصر الأب | — |
result.successes[].post.media[] | objectاختياري / عنصر | — |
result.successes[].post.media[].kind | stringمطلوب في العنصر الأب |
|
result.successes[].post.media[].url | stringمطلوب في العنصر الأب |
|
result.successes[].post.media[].cover_url | string | nullاختياري / عنصر | — |
result.successes[].post.media[].cover_urlanyOf 1 | stringاختياري / عنصر |
|
result.successes[].post.media[].cover_urlanyOf 2 | nullاختياري / عنصر | — |
result.successes[].post.media[].cover_asset_id | integer | nullاختياري / عنصر | — |
result.successes[].post.media[].cover_asset_idanyOf 1 | integerاختياري / عنصر |
|
result.successes[].post.media[].cover_asset_idanyOf 2 | nullاختياري / عنصر | — |
result.successes[].post.media[].asset_id | integer | nullاختياري / عنصر | — |
result.successes[].post.media[].asset_idanyOf 1 | integerاختياري / عنصر |
|
result.successes[].post.media[].asset_idanyOf 2 | nullاختياري / عنصر | — |
result.successes[].post.media[].mime_type | string | nullاختياري / عنصر | — |
result.successes[].post.media[].mime_typeanyOf 1 | stringاختياري / عنصر |
|
result.successes[].post.media[].mime_typeanyOf 2 | nullاختياري / عنصر | — |
result.successes[].post.media[].preview_url | string | nullاختياري / عنصر | URL قراءة مؤقت ومفوّض؛ احتفظ بـ url بوصفه هوية وسائط Scheduled Post المخزّنة. — |
result.successes[].post.media[].preview_urlanyOf 1 | stringاختياري / عنصر |
|
result.successes[].post.media[].preview_urlanyOf 2 | nullاختياري / عنصر | — |
result.successes[].post.media[].cover_preview_url | string | nullاختياري / عنصر | URL قراءة مؤقت ومفوّض للغلاف؛ احتفظ بـ cover_url بوصفه هوية الوسائط المخزّنة. — |
result.successes[].post.media[].cover_preview_urlanyOf 1 | stringاختياري / عنصر |
|
result.successes[].post.media[].cover_preview_urlanyOf 2 | nullاختياري / عنصر | — |
result.successes[].post.media[].preview_expires_at | string | nullاختياري / عنصر | — |
result.successes[].post.media[].preview_expires_atanyOf 1 | stringاختياري / عنصر |
|
result.successes[].post.media[].preview_expires_atanyOf 2 | nullاختياري / عنصر | — |
result.successes[].post.link_url | string | nullاختياري / عنصر | — |
result.successes[].post.link_urlanyOf 1 | stringاختياري / عنصر |
|
result.successes[].post.link_urlanyOf 2 | nullاختياري / عنصر | — |
result.successes[].post.publish_options | objectمطلوب في العنصر الأب | — |
result.successes[].post.publish_options.post_type | stringاختياري / عنصر |
|
result.successes[].post.publish_options.location_id | stringاختياري / عنصر |
|
result.successes[].post.publish_options.share_to_feed | booleanاختياري / عنصر | — |
result.successes[].post.publish_options.collaborators | arrayاختياري / عنصر |
|
result.successes[].post.publish_options.collaborators[] | stringاختياري / عنصر |
|
result.successes[].post.publish_options.first_comment | stringاختياري / عنصر |
|
result.successes[].post.publish_options.topic_tag | stringاختياري / عنصر |
|
result.successes[].post.publish_options.thumb_offset_ms | integerاختياري / عنصر |
|
result.successes[].post.publish_options.title | stringاختياري / عنصر |
|
result.successes[].post.publish_options.youtube_privacy_status | stringاختياري / عنصر |
|
result.successes[].post.publish_options.youtube_category_id | stringاختياري / عنصر |
|
result.successes[].post.publish_options.youtube_contains_synthetic_media | booleanاختياري / عنصر | — |
result.successes[].post.publish_options.description | stringاختياري / عنصر |
|
result.successes[].post.publish_options.category_id | stringاختياري / عنصر |
|
result.successes[].post.publish_options.privacy_status | stringاختياري / عنصر |
|
result.successes[].post.publish_options.cancellation_mode | stringاختياري / عنصر |
|
result.successes[].post.publish_options.tags | arrayاختياري / عنصر | — |
result.successes[].post.publish_options.tags[] | stringاختياري / عنصر | — |
result.successes[].post.publish_options.default_language | stringاختياري / عنصر | — |
result.successes[].post.publish_options.localizations | objectاختياري / عنصر |
|
result.successes[].post.publish_options.localizations.* | any JSON valueاختياري / عنصر | — |
result.successes[].post.publish_options.license | stringاختياري / عنصر |
|
result.successes[].post.publish_options.embeddable | booleanاختياري / عنصر | — |
result.successes[].post.publish_options.public_stats_viewable | booleanاختياري / عنصر | — |
result.successes[].post.publish_options.self_declared_made_for_kids | booleanاختياري / عنصر | — |
result.successes[].post.publish_options.contains_synthetic_media | booleanاختياري / عنصر | — |
result.successes[].post.publish_options.has_paid_product_placement | booleanاختياري / عنصر | — |
result.successes[].post.publish_options.recording_date | stringاختياري / عنصر | — |
result.successes[].post.publish_options.notify_subscribers | booleanاختياري / عنصر | — |
result.successes[].post.publish_options.thumbnail_asset_id | integerاختياري / عنصر |
|
result.successes[].post.publish_options.surface_expectation | stringاختياري / عنصر |
|
result.successes[].post.publish_options.brand_partner | objectاختياري / عنصر |
|
result.successes[].post.publish_options.brand_partner.* | any JSON valueاختياري / عنصر | — |
result.successes[].post.publish_options.cover_asset_id | integerاختياري / عنصر |
|
result.successes[].post.publish_options.audio_name | stringاختياري / عنصر | — |
result.successes[].post.publish_options.trial_params | objectاختياري / عنصر |
|
result.successes[].post.publish_options.trial_params.* | any JSON valueاختياري / عنصر | — |
result.successes[].post.publish_options.is_ai_generated | booleanاختياري / عنصر | — |
result.successes[].post.publish_options.branded_content_sponsor_ids | arrayاختياري / عنصر | — |
result.successes[].post.publish_options.branded_content_sponsor_ids[] | stringاختياري / عنصر | — |
result.successes[].post.publish_options.is_paid_partnership | booleanاختياري / عنصر | — |
result.successes[].post.publish_options.media_options | arrayاختياري / عنصر | — |
result.successes[].post.publish_options.media_options[] | objectاختياري / عنصر |
|
result.successes[].post.publish_options.media_options[].* | any JSON valueاختياري / عنصر | — |
result.successes[].post.publish_options.reply_to_id | stringاختياري / عنصر | — |
result.successes[].post.publish_options.quote_post_id | stringاختياري / عنصر | — |
result.successes[].post.publish_options.repost_target_id | stringاختياري / عنصر | — |
result.successes[].post.publish_options.reply_control | stringاختياري / عنصر | — |
result.successes[].post.publish_options.enable_reply_approvals | booleanاختياري / عنصر | — |
result.successes[].post.publish_options.link_attachment | stringاختياري / عنصر |
|
result.successes[].post.publish_options.poll_attachment | objectاختياري / عنصر |
|
result.successes[].post.publish_options.poll_attachment.* | any JSON valueاختياري / عنصر | — |
result.successes[].post.publish_options.gif_attachment | objectاختياري / عنصر |
|
result.successes[].post.publish_options.gif_attachment.* | any JSON valueاختياري / عنصر | — |
result.successes[].post.publish_options.text_attachment | objectاختياري / عنصر |
|
result.successes[].post.publish_options.text_attachment.* | any JSON valueاختياري / عنصر | — |
result.successes[].post.publish_options.text_entities | arrayاختياري / عنصر | — |
result.successes[].post.publish_options.text_entities[] | objectاختياري / عنصر |
|
result.successes[].post.publish_options.text_entities[].* | any JSON valueاختياري / عنصر | — |
result.successes[].post.publish_options.is_spoiler_media | booleanاختياري / عنصر | — |
result.successes[].post.publish_options.is_ghost_post | booleanاختياري / عنصر | — |
result.successes[].post.publish_options.allowlisted_country_codes | arrayاختياري / عنصر | — |
result.successes[].post.publish_options.allowlisted_country_codes[] | stringاختياري / عنصر | — |
result.successes[].post.publish_options.crossreshare_to_ig | booleanاختياري / عنصر | — |
result.successes[].post.publish_options.crossreshare_to_ig_dark_mode | booleanاختياري / عنصر | — |
result.successes[].post.publish_options.auto_publish_text | booleanاختياري / عنصر | — |
result.successes[].post.publish_options.publication_mode | stringاختياري / عنصر |
|
result.successes[].post.publish_options.backdated_time | numberاختياري / عنصر | — |
result.successes[].post.publish_options.backdated_time_granularity | stringاختياري / عنصر |
|
result.successes[].post.publish_options.place | stringاختياري / عنصر | — |
result.successes[].post.publish_options.feed_targeting | objectاختياري / عنصر |
|
result.successes[].post.publish_options.feed_targeting.* | any JSON valueاختياري / عنصر | — |
result.successes[].post.publish_options.targeting | objectاختياري / عنصر |
|
result.successes[].post.publish_options.targeting.* | any JSON valueاختياري / عنصر | — |
result.successes[].post.publish_options.child_attachments | arrayاختياري / عنصر | — |
result.successes[].post.publish_options.child_attachments[] | objectاختياري / عنصر |
|
result.successes[].post.publish_options.child_attachments[].* | any JSON valueاختياري / عنصر | — |
result.successes[].post.publish_options.multi_share_end_card | booleanاختياري / عنصر | — |
result.successes[].post.publish_options.multi_share_optimized | booleanاختياري / عنصر | — |
result.successes[].post.publish_options.unpublished_content_type | stringاختياري / عنصر | — |
result.successes[].post.publish_options.no_story | booleanاختياري / عنصر | — |
result.successes[].post.publish_options.crossposted_video_id | stringاختياري / عنصر | — |
result.successes[].post.publish_options.spherical | booleanاختياري / عنصر | — |
result.successes[].post.scheduled_at | stringمطلوب في العنصر الأب | — |
result.successes[].post.display_timezone | stringمطلوب في العنصر الأب |
|
result.successes[].post.local_scheduled_at | string | nullاختياري / عنصر | — |
result.successes[].post.local_scheduled_atanyOf 1 | stringاختياري / عنصر |
|
result.successes[].post.local_scheduled_atanyOf 2 | nullاختياري / عنصر | — |
result.successes[].post.schedule_timezone | string | nullاختياري / عنصر | — |
result.successes[].post.schedule_timezoneanyOf 1 | stringاختياري / عنصر |
|
result.successes[].post.schedule_timezoneanyOf 2 | nullاختياري / عنصر | — |
result.successes[].post.schedule_dst_disambiguation | string | nullاختياري / عنصر | — |
result.successes[].post.schedule_dst_disambiguationanyOf 1 | stringاختياري / عنصر |
|
result.successes[].post.schedule_dst_disambiguationanyOf 2 | nullاختياري / عنصر | — |
result.successes[].post.schedule_intent_state | stringاختياري / عنصر |
|
result.successes[].post.expires_at | string | nullمطلوب في العنصر الأب | — |
result.successes[].post.expires_atanyOf 1 | stringمطلوب في العنصر الأب | — |
result.successes[].post.expires_atanyOf 2 | nullمطلوب في العنصر الأب | — |
result.successes[].post.status | stringمطلوب في العنصر الأب |
|
result.successes[].post.version | integerمطلوب في العنصر الأب |
|
result.successes[].post.automatic_retry_enabled | booleanمطلوب في العنصر الأب | — |
result.successes[].post.delete_requested_at | string | nullمطلوب في العنصر الأب | — |
result.successes[].post.delete_requested_atanyOf 1 | stringمطلوب في العنصر الأب | — |
result.successes[].post.delete_requested_atanyOf 2 | nullمطلوب في العنصر الأب | — |
result.successes[].post.published_at | string | nullمطلوب في العنصر الأب | — |
result.successes[].post.published_atanyOf 1 | stringمطلوب في العنصر الأب | — |
result.successes[].post.published_atanyOf 2 | nullمطلوب في العنصر الأب | — |
result.successes[].post.deleted_at | string | nullمطلوب في العنصر الأب | — |
result.successes[].post.deleted_atanyOf 1 | stringمطلوب في العنصر الأب | — |
result.successes[].post.deleted_atanyOf 2 | nullمطلوب في العنصر الأب | — |
result.successes[].post.provider_post_id | string | nullمطلوب في العنصر الأب | — |
result.successes[].post.provider_post_idanyOf 1 | stringمطلوب في العنصر الأب | — |
result.successes[].post.provider_post_idanyOf 2 | nullمطلوب في العنصر الأب | — |
result.successes[].post.permalink | string | nullمطلوب في العنصر الأب | — |
result.successes[].post.permalinkanyOf 1 | stringمطلوب في العنصر الأب |
|
result.successes[].post.permalinkanyOf 2 | nullمطلوب في العنصر الأب | — |
result.successes[].post.created_at | stringمطلوب في العنصر الأب | — |
result.successes[].post.updated_at | stringمطلوب في العنصر الأب | — |
result.successes[].post.project_id | string | nullمطلوب في العنصر الأب | — |
result.successes[].post.project_idanyOf 1 | stringمطلوب في العنصر الأب |
|
result.successes[].post.project_idanyOf 2 | nullمطلوب في العنصر الأب | — |
result.successes[].post.batch_id | string | nullمطلوب في العنصر الأب | — |
result.successes[].post.batch_idanyOf 1 | stringمطلوب في العنصر الأب |
|
result.successes[].post.batch_idanyOf 2 | nullمطلوب في العنصر الأب | — |
result.successes[].post.source_ref | object | nullمطلوب في العنصر الأب | — |
result.successes[].post.source_refanyOf 1 | objectمطلوب في العنصر الأب |
|
result.successes[].post.source_ref.*anyOf 1 | any JSON valueاختياري / عنصر | — |
result.successes[].post.source_refanyOf 2 | nullمطلوب في العنصر الأب | — |
result.failures | arrayمطلوب في العنصر الأب | — |
result.failures[] | objectاختياري / عنصر | — |
result.failures[].social_account_id | stringمطلوب في العنصر الأب |
|
result.failures[].code | stringمطلوب في العنصر الأب | — |
result.failures[].message | stringمطلوب في العنصر الأب | — |
مخطط JSON Schema الكامل
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"draft": {
"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)$"
},
"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)$"
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"state": {
"type": "string",
"enum": [
"draft",
"submitting",
"submitted"
]
},
"content": {
"type": "object",
"properties": {
"schemaVersion": {
"default": 1,
"type": "number",
"const": 1
},
"accountIds": {
"default": [],
"maxItems": 50,
"type": "array",
"items": {
"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)$"
}
},
"caption": {
"default": "",
"type": "string",
"maxLength": 5000
},
"hashtags": {
"default": "",
"type": "string",
"maxLength": 5000
},
"assetIds": {
"default": [],
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"maxLength": 16,
"pattern": "^[1-9][0-9]*$"
}
},
"threadsTextOnly": {
"default": false,
"type": "boolean"
},
"instagramMode": {
"default": "REELS",
"type": "string",
"enum": [
"IMAGE",
"REELS",
"CAROUSEL",
"STORY_IMAGE",
"STORY_VIDEO"
]
},
"youtubeTitle": {
"default": "",
"type": "string",
"maxLength": 100
},
"youtubePrivacy": {
"default": "private",
"type": "string",
"enum": [
"private",
"unlisted",
"public"
]
},
"youtubeSynthetic": {
"default": false,
"type": "boolean"
},
"youtubeCategoryId": {
"default": "",
"type": "string",
"maxLength": 32
},
"youtubeShort": {
"default": false,
"type": "boolean"
},
"linkUrl": {
"default": "",
"type": "string",
"maxLength": 2048
},
"scheduledAt": {
"default": "",
"type": "string",
"maxLength": 64
},
"displayTimezone": {
"default": "UTC",
"type": "string",
"minLength": 1,
"maxLength": 128
},
"publishNow": {
"default": false,
"type": "boolean"
},
"destinationOverrides": {
"default": {},
"type": "object",
"propertyNames": {
"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)$"
},
"additionalProperties": {
"type": "object",
"properties": {
"caption": {
"type": "string",
"maxLength": 5000
},
"scheduledAt": {
"type": "string",
"maxLength": 64
}
}
}
},
"expiresAt": {
"default": "",
"type": "string",
"maxLength": 64
}
},
"required": [
"schemaVersion",
"accountIds",
"caption",
"hashtags",
"assetIds",
"threadsTextOnly",
"instagramMode",
"youtubeTitle",
"youtubePrivacy",
"youtubeSynthetic",
"youtubeCategoryId",
"youtubeShort",
"linkUrl",
"scheduledAt",
"displayTimezone",
"publishNow",
"destinationOverrides",
"expiresAt"
]
},
"created_by": {
"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"
}
]
},
"updated_by": {
"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"
}
]
},
"created_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)))$"
},
"updated_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)))$"
},
"submission": {
"anyOf": [
{
"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)$"
},
"expected_revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"started_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)))$"
},
"receipt": {
"anyOf": [
{
"type": "object",
"properties": {
"batch_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"
}
]
},
"successes": {
"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)$"
},
"post_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": [
"social_account_id",
"post_id"
]
}
},
"failures": {
"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)$"
},
"code": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"message": {
"type": "string",
"maxLength": 2000
}
},
"required": [
"social_account_id",
"code",
"message"
]
}
}
},
"required": [
"batch_id",
"successes",
"failures"
]
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"expected_revision",
"started_at",
"receipt"
]
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"workspace_id",
"revision",
"state",
"content",
"created_by",
"updated_by",
"created_at",
"updated_at",
"submission"
]
},
"result": {
"type": "object",
"properties": {
"batch_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"
}
]
},
"successes": {
"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)$"
},
"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"
},
"project_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"
}
]
},
"batch_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"
}
]
},
"source_ref": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"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",
"project_id",
"batch_id",
"source_ref"
]
}
},
"required": [
"social_account_id",
"post"
]
}
},
"failures": {
"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)$"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"social_account_id",
"code",
"message"
]
}
}
},
"required": [
"batch_id",
"successes",
"failures"
]
}
},
"required": [
"draft",
"result"
]
}الأخطاء وإعادة المحاولة بأمان
افحص حالة 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": "44444444-4444-4444-8444-444444444444",
"expected_revision": 2,
"mutation_id": "77777777-7777-4777-8777-777777777777",
"content": {
"schemaVersion": 1,
"accountIds": [
"22222222-2222-4222-8222-222222222222"
],
"caption": "A fictional announcement approved for this example.",
"hashtags": "",
"assetIds": [],
"threadsTextOnly": false,
"instagramMode": "REELS",
"youtubeTitle": "",
"youtubePrivacy": "private",
"youtubeSynthetic": false,
"youtubeCategoryId": "",
"youtubeShort": false,
"linkUrl": "",
"scheduledAt": "2099-01-15T09:00:00",
"displayTimezone": "UTC",
"publishNow": false,
"destinationOverrides": {},
"expiresAt": ""
},
"request": {
"workspace_id": "11111111-1111-4111-8111-111111111111",
"targets": [
{
"social_account_id": "22222222-2222-4222-8222-222222222222",
"caption": "A fictional announcement approved for this example.",
"hashtags": [],
"media": [],
"provider_payload": {
"platform": "x",
"publish_options": {
"post_type": "TEXT"
}
},
"scheduled_at": "2099-01-15T09:00:00Z",
"display_timezone": "UTC",
"idempotency_key": "example-target-0001"
}
]
}
}cURL
curl --request POST \
"https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/content-drafts/submit" \
-H "Authorization: Bearer $SOSOAPI_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
--data-binary @request.jsonJavaScript
// 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/content-drafts/submit", {
method: "POST",
headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
body: JSON.stringify({
"id": "44444444-4444-4444-8444-444444444444",
"expected_revision": 2,
"mutation_id": "77777777-7777-4777-8777-777777777777",
"content": {
"schemaVersion": 1,
"accountIds": [
"22222222-2222-4222-8222-222222222222"
],
"caption": "A fictional announcement approved for this example.",
"hashtags": "",
"assetIds": [],
"threadsTextOnly": false,
"instagramMode": "REELS",
"youtubeTitle": "",
"youtubePrivacy": "private",
"youtubeSynthetic": false,
"youtubeCategoryId": "",
"youtubeShort": false,
"linkUrl": "",
"scheduledAt": "2099-01-15T09:00:00",
"displayTimezone": "UTC",
"publishNow": false,
"destinationOverrides": {},
"expiresAt": ""
},
"request": {
"workspace_id": "11111111-1111-4111-8111-111111111111",
"targets": [
{
"social_account_id": "22222222-2222-4222-8222-222222222222",
"caption": "A fictional announcement approved for this example.",
"hashtags": [],
"media": [],
"provider_payload": {
"platform": "x",
"publish_options": {
"post_type": "TEXT"
}
},
"scheduled_at": "2099-01-15T09:00:00Z",
"display_timezone": "UTC",
"idempotency_key": "example-target-0001"
}
]
}
})
});
const result = await response.json();
// Check response.ok, the operation-specific body and completion state before continuing.CLI
npx sosoapi api post /studio-api/content-drafts/submit < request.jsonمثال استجابة اصطناعية
{
"draft": {
"id": "44444444-4444-4444-8444-444444444444",
"workspace_id": "11111111-1111-4111-8111-111111111111",
"revision": 2,
"state": "draft",
"content": {
"schemaVersion": 1,
"accountIds": [
"22222222-2222-4222-8222-222222222222"
],
"caption": "A fictional announcement approved for this example.",
"hashtags": "",
"assetIds": [],
"threadsTextOnly": false,
"instagramMode": "REELS",
"youtubeTitle": "",
"youtubePrivacy": "private",
"youtubeSynthetic": false,
"youtubeCategoryId": "",
"youtubeShort": false,
"linkUrl": "",
"scheduledAt": "2099-01-15T09:00:00",
"displayTimezone": "UTC",
"publishNow": false,
"destinationOverrides": {},
"expiresAt": ""
},
"created_by": null,
"updated_by": null,
"created_at": "2099-01-15T08:00:00Z",
"updated_at": "2099-01-15T08:30:00Z",
"submission": null
},
"result": {
"batch_id": null,
"successes": [],
"failures": [
{
"social_account_id": "22222222-2222-4222-8222-222222222222",
"code": "DESTINATION_INVALID",
"message": "This fictional destination needs repair before submission."
}
]
}
}