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

A keresés csak használatkor töltődik be. Alább minden kategória böngészhető.

Időzítés és közzététel

Időzített bejegyzés visszavonása

A még közzé nem tett időzített bejegyzés visszavonása, hogy ne jelenjen meg. A közzétett bejegyzést elutasítja; az ügynök közzétett tartalmat sem törölhet: ezt a felhasználó a webalkalmazásban végzi. expected_version szükséges.

POST /studio-api/scheduled-posts/cancel

Szerződés ellenőrizve: · sha256:563d2d581da0ad29

Olvasás Markdown formátumbanNyilvános szerződés letöltéseOpenAPI letöltése

Áttekintés

A még közzé nem tett időzített bejegyzés visszavonása, hogy ne jelenjen meg. A közzétett bejegyzést elutasítja; az ügynök közzétett tartalmat sem törölhet: ezt a felhasználó a webalkalmazásban végzi. expected_version szükséges.

A sikeres HTTP-válasz jelentheti a kérés elfogadását, nem a befejezését. Háttérmunkánál mentsd a visszakapott azonosítót, és ugyanazt a műveletet ellenőrizd a befejezésig. Az időzített vagy elfogadott bejegyzés csak platformmegerősítés után közzétett; a kliens időtúllépése nem igazolja az eredményt.

Hitelesítés és engedélyek

Elfogadott hitelesítőadat-osztályok
user_session, delegated_oauth, personal_access_token
Delegált képesség
agent:publish
Minimális munkaterületi szerepkör
editor
Hozzáférési hatókör
A felhasználó számára engedélyezett erőforrások
Minden munkaterületre kiterjedő hozzájárulás szükséges
Nem
Állapotot módosít
Igen
A művelet befejezésekor
terminal publication outcome

A token csak a tulajdonosa jogait használhatja. Minden kérés ellenőrzi a munkaterületi tagságot, erőforrás-tulajdonjogot, kiválasztott munkaterületeket és megadott képességeket. A core és full profil a megjelenített eszközöket változtatja; hozzáférést nem ad.

Kérésmezők

A kötelező jelölés a szülőobjektumon és a kiválasztott ágon belül érvényes. A kötelező gyermek nem teszi kötelezővé az opcionális szülőt. Az alábbi szabályok és mezőnevek a szerződésből származnak.

Kérésmezők
Mező / ágTípus / kötelezőKorlátok
$objectA szülőn belül kötelező
  • additionalProperties: false
idstringA szülőn belül kötelező
  • 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}$"
expected_versionintegerA szülőn belül kötelező
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
Teljes JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
    },
    "expected_version": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "id",
    "expected_version"
  ],
  "additionalProperties": false
}

Válasz és befejezés

Sikeres HTTP-állapotok: 200. A művelet befejezésekor: terminal publication outcome.

A sikeres HTTP-válasz jelentheti a kérés elfogadását, nem a befejezését. Háttérmunkánál mentsd a visszakapott azonosítót, és ugyanazt a műveletet ellenőrizd a befejezésig. Az időzített vagy elfogadott bejegyzés csak platformmegerősítés után közzétett; a kliens időtúllépése nem igazolja az eredményt.

A kötelező jelölés a szülőobjektumon és a kiválasztott ágon belül érvényes. A kötelező gyermek nem teszi kötelezővé az opcionális szülőt. Az alábbi szabályok és mezőnevek a szerződésből származnak.

Válasz és befejezés
Mező / ágTípus / kötelezőKorlátok
$objectA szülőn belül kötelező—
postobjectA szülőn belül kötelező—
post.idstringA szülőn belül kötelező
  • pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
post.workspace_idstringA szülőn belül kötelező
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
post.social_account_idstring | nullA szülőn belül kötelező—
post.social_account_idanyOf 1stringA szülőn belül kötelező
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
post.social_account_idanyOf 2nullA szülőn belül kötelező—
post.platformstringA szülőn belül kötelező
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destinationobjectA szülőn belül kötelező—
post.destination.social_account_idstring | nullA szülőn belül kötelező—
post.destination.social_account_idanyOf 1stringA szülőn belül kötelező
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
post.destination.social_account_idanyOf 2nullA szülőn belül kötelező—
post.destination.platformstringA szülőn belül kötelező
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destination.platform_user_idstring | nullA szülőn belül kötelező—
post.destination.platform_user_idanyOf 1stringA szülőn belül kötelező—
post.destination.platform_user_idanyOf 2nullA szülőn belül kötelező—
post.destination.account_labelstring | nullA szülőn belül kötelező—
post.destination.account_labelanyOf 1stringA szülőn belül kötelező—
post.destination.account_labelanyOf 2nullA szülőn belül kötelező—
post.captionstring | nullA szülőn belül kötelező—
post.captionanyOf 1stringA szülőn belül kötelező—
post.captionanyOf 2nullA szülőn belül kötelező—
post.hashtagsarrayA szülőn belül kötelező—
post.hashtags[]stringOpcionális / elem—
post.mediaarrayA szülőn belül kötelező—
post.media[]objectOpcionális / elem—
post.media[].kindstringA szülőn belül kötelező
  • enum: ["image","video"]
post.media[].urlstringA szülőn belül kötelező
  • format: "uri"
post.media[].cover_urlstring | nullOpcionális / elem—
post.media[].cover_urlanyOf 1stringOpcionális / elem
  • format: "uri"
post.media[].cover_urlanyOf 2nullOpcionális / elem—
post.media[].cover_asset_idinteger | nullOpcionális / elem—
post.media[].cover_asset_idanyOf 1integerOpcionális / elem
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.media[].cover_asset_idanyOf 2nullOpcionális / elem—
post.media[].asset_idinteger | nullOpcionális / elem—
post.media[].asset_idanyOf 1integerOpcionális / elem
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.media[].asset_idanyOf 2nullOpcionális / elem—
post.media[].mime_typestring | nullOpcionális / elem—
post.media[].mime_typeanyOf 1stringOpcionális / elem
  • minLength: 1
  • maxLength: 160
post.media[].mime_typeanyOf 2nullOpcionális / elem—
post.media[].preview_urlstring | nullOpcionális / elem

Ideiglenes, engedélyezett olvasási URL; a tartós Scheduled Post médiaazonosság maradjon a url.

—
post.media[].preview_urlanyOf 1stringOpcionális / elem
  • format: "uri"
post.media[].preview_urlanyOf 2nullOpcionális / elem—
post.media[].cover_preview_urlstring | nullOpcionális / elem

Ideiglenes, engedélyezett borítókép-olvasási URL; a tartós médiaazonosság maradjon a cover_url.

—
post.media[].cover_preview_urlanyOf 1stringOpcionális / elem
  • format: "uri"
post.media[].cover_preview_urlanyOf 2nullOpcionális / elem—
post.media[].preview_expires_atstring | nullOpcionális / elem—
post.media[].preview_expires_atanyOf 1stringOpcionális / elem
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
post.media[].preview_expires_atanyOf 2nullOpcionális / elem—
post.link_urlstring | nullOpcionális / elem—
post.link_urlanyOf 1stringOpcionális / elem
  • format: "uri"
post.link_urlanyOf 2nullOpcionális / elem—
post.publish_optionsobjectA szülőn belül kötelező—
post.publish_options.post_typestringOpcionális / elem
  • enum: ["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]
post.publish_options.location_idstringOpcionális / elem
  • minLength: 1
post.publish_options.share_to_feedbooleanOpcionális / elem—
post.publish_options.collaboratorsarrayOpcionális / elem
  • maxItems: 3
post.publish_options.collaborators[]stringOpcionális / elem
  • minLength: 1
post.publish_options.first_commentstringOpcionális / elem
  • minLength: 1
  • maxLength: 2200
post.publish_options.topic_tagstringOpcionális / elem
  • minLength: 1
post.publish_options.thumb_offset_msintegerOpcionális / elem
  • minimum: 0
  • maximum: 9007199254740991
post.publish_options.titlestringOpcionális / elem
  • maxLength: 255
post.publish_options.youtube_privacy_statusstringOpcionális / elem
  • enum: ["private","unlisted","public"]
post.publish_options.youtube_category_idstringOpcionális / elem
  • pattern: "^\\d+$"
post.publish_options.youtube_contains_synthetic_mediabooleanOpcionális / elem—
post.publish_options.descriptionstringOpcionális / elem
  • maxLength: 5000
post.publish_options.category_idstringOpcionális / elem
  • pattern: "^\\d+$"
post.publish_options.privacy_statusstringOpcionális / elem
  • enum: ["private","unlisted","public"]
post.publish_options.cancellation_modestringOpcionális / elem
  • enum: ["DELETE","UNSCHEDULE_KEEP_PRIVATE"]
post.publish_options.tagsarrayOpcionális / elem—
post.publish_options.tags[]stringOpcionális / elem—
post.publish_options.default_languagestringOpcionális / elem—
post.publish_options.localizationsobjectOpcionális / elem
  • additionalProperties: {}
post.publish_options.localizations.*any JSON valueOpcionális / elem—
post.publish_options.licensestringOpcionális / elem
  • enum: ["youtube","creativeCommon"]
post.publish_options.embeddablebooleanOpcionális / elem—
post.publish_options.public_stats_viewablebooleanOpcionális / elem—
post.publish_options.self_declared_made_for_kidsbooleanOpcionális / elem—
post.publish_options.contains_synthetic_mediabooleanOpcionális / elem—
post.publish_options.has_paid_product_placementbooleanOpcionális / elem—
post.publish_options.recording_datestringOpcionális / elem—
post.publish_options.notify_subscribersbooleanOpcionális / elem—
post.publish_options.thumbnail_asset_idintegerOpcionális / elem
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.publish_options.surface_expectationstringOpcionális / elem
  • const: "SHORT"
post.publish_options.brand_partnerobjectOpcionális / elem
  • additionalProperties: {}
post.publish_options.brand_partner.*any JSON valueOpcionális / elem—
post.publish_options.cover_asset_idintegerOpcionális / elem
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.publish_options.audio_namestringOpcionális / elem—
post.publish_options.trial_paramsobjectOpcionális / elem
  • additionalProperties: {}
post.publish_options.trial_params.*any JSON valueOpcionális / elem—
post.publish_options.is_ai_generatedbooleanOpcionális / elem—
post.publish_options.branded_content_sponsor_idsarrayOpcionális / elem—
post.publish_options.branded_content_sponsor_ids[]stringOpcionális / elem—
post.publish_options.is_paid_partnershipbooleanOpcionális / elem—
post.publish_options.media_optionsarrayOpcionális / elem—
post.publish_options.media_options[]objectOpcionális / elem
  • additionalProperties: {}
post.publish_options.media_options[].*any JSON valueOpcionális / elem—
post.publish_options.reply_to_idstringOpcionális / elem—
post.publish_options.quote_post_idstringOpcionális / elem—
post.publish_options.repost_target_idstringOpcionális / elem—
post.publish_options.reply_controlstringOpcionális / elem—
post.publish_options.enable_reply_approvalsbooleanOpcionális / elem—
post.publish_options.link_attachmentstringOpcionális / elem
  • format: "uri"
post.publish_options.poll_attachmentobjectOpcionális / elem
  • additionalProperties: {}
post.publish_options.poll_attachment.*any JSON valueOpcionális / elem—
post.publish_options.gif_attachmentobjectOpcionális / elem
  • additionalProperties: {}
post.publish_options.gif_attachment.*any JSON valueOpcionális / elem—
post.publish_options.text_attachmentobjectOpcionális / elem
  • additionalProperties: {}
post.publish_options.text_attachment.*any JSON valueOpcionális / elem—
post.publish_options.text_entitiesarrayOpcionális / elem—
post.publish_options.text_entities[]objectOpcionális / elem
  • additionalProperties: {}
post.publish_options.text_entities[].*any JSON valueOpcionális / elem—
post.publish_options.is_spoiler_mediabooleanOpcionális / elem—
post.publish_options.is_ghost_postbooleanOpcionális / elem—
post.publish_options.allowlisted_country_codesarrayOpcionális / elem—
post.publish_options.allowlisted_country_codes[]stringOpcionális / elem—
post.publish_options.crossreshare_to_igbooleanOpcionális / elem—
post.publish_options.crossreshare_to_ig_dark_modebooleanOpcionális / elem—
post.publish_options.auto_publish_textbooleanOpcionális / elem—
post.publish_options.publication_modestringOpcionális / elem
  • enum: ["PUBLISH","DRAFT"]
post.publish_options.backdated_timenumberOpcionális / elem—
post.publish_options.backdated_time_granularitystringOpcionális / elem
  • enum: ["year","month","day","hour","minute"]
post.publish_options.placestringOpcionális / elem—
post.publish_options.feed_targetingobjectOpcionális / elem
  • additionalProperties: {}
post.publish_options.feed_targeting.*any JSON valueOpcionális / elem—
post.publish_options.targetingobjectOpcionális / elem
  • additionalProperties: {}
post.publish_options.targeting.*any JSON valueOpcionális / elem—
post.publish_options.child_attachmentsarrayOpcionális / elem—
post.publish_options.child_attachments[]objectOpcionális / elem
  • additionalProperties: {}
post.publish_options.child_attachments[].*any JSON valueOpcionális / elem—
post.publish_options.multi_share_end_cardbooleanOpcionális / elem—
post.publish_options.multi_share_optimizedbooleanOpcionális / elem—
post.publish_options.unpublished_content_typestringOpcionális / elem—
post.publish_options.no_storybooleanOpcionális / elem—
post.publish_options.crossposted_video_idstringOpcionális / elem—
post.publish_options.sphericalbooleanOpcionális / elem—
post.scheduled_atstringA szülőn belül kötelező—
post.display_timezonestringA szülőn belül kötelező
  • minLength: 1
  • maxLength: 80
post.local_scheduled_atstring | nullOpcionális / elem—
post.local_scheduled_atanyOf 1stringOpcionális / elem
  • pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
post.local_scheduled_atanyOf 2nullOpcionális / elem—
post.schedule_timezonestring | nullOpcionális / elem—
post.schedule_timezoneanyOf 1stringOpcionális / elem
  • minLength: 1
  • maxLength: 80
post.schedule_timezoneanyOf 2nullOpcionális / elem—
post.schedule_dst_disambiguationstring | nullOpcionális / elem—
post.schedule_dst_disambiguationanyOf 1stringOpcionális / elem
  • enum: ["exact","earlier","later"]
post.schedule_dst_disambiguationanyOf 2nullOpcionális / elem—
post.schedule_intent_statestringOpcionális / elem
  • enum: ["verified","legacy_unverified"]
post.expires_atstring | nullA szülőn belül kötelező—
post.expires_atanyOf 1stringA szülőn belül kötelező—
post.expires_atanyOf 2nullA szülőn belül kötelező—
post.statusstringA szülőn belül kötelező
  • enum: ["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]
post.versionintegerA szülőn belül kötelező
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.automatic_retry_enabledbooleanA szülőn belül kötelező—
post.delete_requested_atstring | nullA szülőn belül kötelező—
post.delete_requested_atanyOf 1stringA szülőn belül kötelező—
post.delete_requested_atanyOf 2nullA szülőn belül kötelező—
post.published_atstring | nullA szülőn belül kötelező—
post.published_atanyOf 1stringA szülőn belül kötelező—
post.published_atanyOf 2nullA szülőn belül kötelező—
post.deleted_atstring | nullA szülőn belül kötelező—
post.deleted_atanyOf 1stringA szülőn belül kötelező—
post.deleted_atanyOf 2nullA szülőn belül kötelező—
post.provider_post_idstring | nullA szülőn belül kötelező—
post.provider_post_idanyOf 1stringA szülőn belül kötelező—
post.provider_post_idanyOf 2nullA szülőn belül kötelező—
post.permalinkstring | nullA szülőn belül kötelező—
post.permalinkanyOf 1stringA szülőn belül kötelező
  • format: "uri"
post.permalinkanyOf 2nullA szülőn belül kötelező—
post.created_atstringA szülőn belül kötelező—
post.updated_atstringA szülőn belül kötelező—
post.project_idstring | nullA szülőn belül kötelező—
post.project_idanyOf 1stringA szülőn belül kötelező
  • 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.project_idanyOf 2nullA szülőn belül kötelező—
post.batch_idstring | nullA szülőn belül kötelező—
post.batch_idanyOf 1stringA szülőn belül kötelező
  • 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.batch_idanyOf 2nullA szülőn belül kötelező—
post.source_refobject | nullA szülőn belül kötelező—
post.source_refanyOf 1objectA szülőn belül kötelező
  • additionalProperties: {}
post.source_ref.*anyOf 1any JSON valueOpcionális / elem—
post.source_refanyOf 2nullA szülőn belül kötelező—
Teljes JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "post": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
        },
        "workspace_id": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "social_account_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            {
              "type": "null"
            }
          ]
        },
        "platform": {
          "type": "string",
          "enum": [
            "instagram",
            "threads",
            "facebook",
            "youtube",
            "x"
          ]
        },
        "destination": {
          "type": "object",
          "properties": {
            "social_account_id": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid",
                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "platform": {
              "type": "string",
              "enum": [
                "instagram",
                "threads",
                "facebook",
                "youtube",
                "x"
              ]
            },
            "platform_user_id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "account_label": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "social_account_id",
            "platform",
            "platform_user_id",
            "account_label"
          ]
        },
        "caption": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "hashtags": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "media": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "image",
                  "video"
                ]
              },
              "url": {
                "type": "string",
                "format": "uri"
              },
              "cover_url": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "uri"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "cover_asset_id": {
                "anyOf": [
                  {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "asset_id": {
                "anyOf": [
                  {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "mime_type": {
                "anyOf": [
                  {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 160
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "preview_url": {
                "description": "Temporary authorized read URL; keep url as persisted Scheduled Post media identity.",
                "anyOf": [
                  {
                    "type": "string",
                    "format": "uri"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "cover_preview_url": {
                "description": "Temporary authorized cover read URL; keep cover_url as persisted media identity.",
                "anyOf": [
                  {
                    "type": "string",
                    "format": "uri"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "preview_expires_at": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "kind",
              "url"
            ]
          }
        },
        "link_url": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "publish_options": {
          "type": "object",
          "properties": {
            "post_type": {
              "type": "string",
              "enum": [
                "TEXT",
                "LINK",
                "IMAGE",
                "MULTI_IMAGE",
                "VIDEO",
                "CAROUSEL",
                "REELS",
                "STORY_IMAGE",
                "STORY_VIDEO",
                "REPOST",
                "SHORT"
              ]
            },
            "location_id": {
              "type": "string",
              "minLength": 1
            },
            "share_to_feed": {
              "type": "boolean"
            },
            "collaborators": {
              "maxItems": 3,
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1
              }
            },
            "first_comment": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2200
            },
            "topic_tag": {
              "type": "string",
              "minLength": 1
            },
            "thumb_offset_ms": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "title": {
              "type": "string",
              "maxLength": 255
            },
            "youtube_privacy_status": {
              "type": "string",
              "enum": [
                "private",
                "unlisted",
                "public"
              ]
            },
            "youtube_category_id": {
              "type": "string",
              "pattern": "^\\d+$"
            },
            "youtube_contains_synthetic_media": {
              "type": "boolean"
            },
            "description": {
              "type": "string",
              "maxLength": 5000
            },
            "category_id": {
              "type": "string",
              "pattern": "^\\d+$"
            },
            "privacy_status": {
              "type": "string",
              "enum": [
                "private",
                "unlisted",
                "public"
              ]
            },
            "cancellation_mode": {
              "type": "string",
              "enum": [
                "DELETE",
                "UNSCHEDULE_KEEP_PRIVATE"
              ]
            },
            "tags": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "default_language": {
              "type": "string"
            },
            "localizations": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "license": {
              "type": "string",
              "enum": [
                "youtube",
                "creativeCommon"
              ]
            },
            "embeddable": {
              "type": "boolean"
            },
            "public_stats_viewable": {
              "type": "boolean"
            },
            "self_declared_made_for_kids": {
              "type": "boolean"
            },
            "contains_synthetic_media": {
              "type": "boolean"
            },
            "has_paid_product_placement": {
              "type": "boolean"
            },
            "recording_date": {
              "type": "string"
            },
            "notify_subscribers": {
              "type": "boolean"
            },
            "thumbnail_asset_id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            "surface_expectation": {
              "type": "string",
              "const": "SHORT"
            },
            "brand_partner": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "cover_asset_id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            "audio_name": {
              "type": "string"
            },
            "trial_params": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "is_ai_generated": {
              "type": "boolean"
            },
            "branded_content_sponsor_ids": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "is_paid_partnership": {
              "type": "boolean"
            },
            "media_options": {
              "type": "array",
              "items": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              }
            },
            "reply_to_id": {
              "type": "string"
            },
            "quote_post_id": {
              "type": "string"
            },
            "repost_target_id": {
              "type": "string"
            },
            "reply_control": {
              "type": "string"
            },
            "enable_reply_approvals": {
              "type": "boolean"
            },
            "link_attachment": {
              "type": "string",
              "format": "uri"
            },
            "poll_attachment": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "gif_attachment": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "text_attachment": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "text_entities": {
              "type": "array",
              "items": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              }
            },
            "is_spoiler_media": {
              "type": "boolean"
            },
            "is_ghost_post": {
              "type": "boolean"
            },
            "allowlisted_country_codes": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "crossreshare_to_ig": {
              "type": "boolean"
            },
            "crossreshare_to_ig_dark_mode": {
              "type": "boolean"
            },
            "auto_publish_text": {
              "type": "boolean"
            },
            "publication_mode": {
              "type": "string",
              "enum": [
                "PUBLISH",
                "DRAFT"
              ]
            },
            "backdated_time": {
              "type": "number"
            },
            "backdated_time_granularity": {
              "type": "string",
              "enum": [
                "year",
                "month",
                "day",
                "hour",
                "minute"
              ]
            },
            "place": {
              "type": "string"
            },
            "feed_targeting": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "targeting": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "child_attachments": {
              "type": "array",
              "items": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              }
            },
            "multi_share_end_card": {
              "type": "boolean"
            },
            "multi_share_optimized": {
              "type": "boolean"
            },
            "unpublished_content_type": {
              "type": "string"
            },
            "no_story": {
              "type": "boolean"
            },
            "crossposted_video_id": {
              "type": "string"
            },
            "spherical": {
              "type": "boolean"
            }
          }
        },
        "scheduled_at": {
          "type": "string"
        },
        "display_timezone": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        "local_scheduled_at": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
            },
            {
              "type": "null"
            }
          ]
        },
        "schedule_timezone": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1,
              "maxLength": 80
            },
            {
              "type": "null"
            }
          ]
        },
        "schedule_dst_disambiguation": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "exact",
                "earlier",
                "later"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "schedule_intent_state": {
          "type": "string",
          "enum": [
            "verified",
            "legacy_unverified"
          ]
        },
        "expires_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "status": {
          "type": "string",
          "enum": [
            "scheduled",
            "publishing",
            "published",
            "failed",
            "expired",
            "needs_reschedule",
            "cancelled",
            "deleted"
          ]
        },
        "version": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        "automatic_retry_enabled": {
          "type": "boolean"
        },
        "delete_requested_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "published_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "deleted_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "provider_post_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "permalink": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "created_at": {
          "type": "string"
        },
        "updated_at": {
          "type": "string"
        },
        "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": [
    "post"
  ]
}

Hibák és biztonságos újrapróbálás

Ellenőrizd a HTTP-állapotot és a válasz törzsét. A 400 ellenőrzési hiba ZodError értéket tartalmazhat; a kezelőhibák az error, message és code mezőket használják. Őrizd meg a request_id vagy x-request-id értéket a diagnózishoz, hitelesítő adatok nélkül. Újrapróbálás előtt javítsd a 401/403 hozzáférési hibákat; 429 esetén kövesd a Retry-After értékét. Bizonytalan írás vagy 5xx válasz esetén előbb olvasd el a meglévő eredményt. Csak támogatott műveletnél használj újra idempotenciakulcsot; az újrapróbálás műveletenként eltér, és nem garantál pontosan egyszeri kézbesítést.

Hibaelhárítási útmutató

Példák

A példák sémákkal ellenőrzött képzeletbeli értékeket használnak. Az azonosítókat engedélyezettekre, a médiát kész tartalomelemekre, a dátumokat megerősített közzétételi időpontra cseréld. Írás beküldése előtt ellenőrizd a fiók jogosultságát. Ez az oldal nem küld API-kérést.

A szervereden állítsd a SOSOAPI_ACCESS_TOKEN értékét a művelet által elfogadott hitelesítő adatra, és tartsd távol a böngészőkódtól. Ügynökhöz a sosoapi auth login paranccsal jelentkezz be böngészőben, és hagyd, hogy a CLI frissítse a hitelesítő adatokat.

request.json

{
  "id": "11111111-1111-4111-8111-111111111111",
  "expected_version": 1
}

cURL

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

JavaScript

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

CLI

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

Szintetikus válaszpélda

{
  "post": {
    "id": "11111111-1111-4111-8111-111111111111",
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "social_account_id": null,
    "platform": "instagram",
    "destination": {
      "social_account_id": null,
      "platform": "instagram",
      "platform_user_id": null,
      "account_label": null
    },
    "caption": null,
    "hashtags": [],
    "media": [],
    "publish_options": {},
    "scheduled_at": "example",
    "display_timezone": "UTC",
    "expires_at": null,
    "status": "scheduled",
    "version": 1,
    "automatic_retry_enabled": false,
    "delete_requested_at": null,
    "published_at": null,
    "deleted_at": null,
    "provider_post_id": null,
    "permalink": null,
    "created_at": "example",
    "updated_at": "example",
    "project_id": null,
    "batch_id": null,
    "source_ref": null
  }
}

MCP: sosoapi_cancel_scheduled_post

Minden API-műveletHitelesítés és engedélyek