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

Pencarian hanya dimuat saat digunakan. Jelajahi semua kategori di bawah.

Alat MCP

Dapatkan status impor aset

sosoapi_get_asset_import_status

Baca impor berdasarkan import_id. Untuk memposting, sertakan include_asset=true: hasil ready memuat ID aset terdaftar, kind, dan asset_url stabil, sehingga tidak perlu get_asset terpisah. Aset tertunda atau tidak ada tidak dapat dijadwalkan. Jangan pernah menggunakan URL sumber atau pratinjau sebagai identitas media. Jika terhenti, baca sosoapi_job_status dengan job_id; jangan pernah memulai impor duplikat.

Baca sebagai Markdown

Profil dan transport

Profil: core, full · Transport: stdio, http

Pilih core atau full untuk mengatur alat yang terlihat oleh klien; ini tidak mengubah izinnya. Unggahan file lokal memerlukan stdio dan tidak tersedia melalui HTTP. Atur SOSOAPI_OUTPUT_SCHEMAS=1 untuk menyertakan skema output saat penemuan. Alat mengembalikan hasil terstruktur dengan atau tanpa pengaturan itu.

Izin dan efek samping

Anotasi membantu klien menjelaskan alat. Setiap panggilan tetap memeriksa autentikasi pengguna, peran, akses sumber daya, dan izin kemampuan.

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

Kolom input

Wajib berarti wajib dalam objek induk dan cabang yang dipilih. Anak wajib tidak membuat induk opsional menjadi wajib. Aturan dan nama kolom di bawah disalin dari kontrak.

Kolom input
Kolom / cabangJenis / wajibBatasan
$objectWajib dalam induk
  • additionalProperties: false
workspace_idstringWajib dalam induk
  • format: "uuid"
import_idstringWajib dalam induk
  • format: "uuid"
include_assetbooleanOpsional / item—
JSON Schema lengkap
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "import_id": {
      "type": "string",
      "format": "uuid"
    },
    "include_asset": {
      "type": "boolean"
    }
  },
  "required": [
    "workspace_id",
    "import_id"
  ],
  "additionalProperties": false
}

Output terstruktur

Skema ini menjelaskan structuredContent dalam hasil alat yang berhasil. Respons MCP juga menyertakan content dan dapat menetapkan isError saat panggilan gagal. Untuk publikasi, baca hasil akhir postingan alih-alih menganggap permintaan diterima atau respons teks sebagai konfirmasi. Operasi API yang ditautkan menjelaskan izin dan aturan percobaan ulang.

Wajib berarti wajib dalam objek induk dan cabang yang dipilih. Anak wajib tidak membuat induk opsional menjadi wajib. Aturan dan nama kolom di bawah disalin dari kontrak.

Output terstruktur
Kolom / cabangJenis / wajibBatasan
$objectWajib dalam induk
  • additionalProperties: false
importobjectWajib dalam induk
  • additionalProperties: false
import.idstringWajib dalam induk
  • format: "uuid"
import.statusstringWajib dalam induk
  • enum: ["queued","importing","needs_repair","ready","asset_purged","failed"]
import.job_idstring | nullWajib dalam induk—
import.job_idanyOf 1stringWajib dalam induk
  • format: "uuid"
import.job_idanyOf 2nullWajib dalam induk—
import.asset_idinteger | nullWajib dalam induk—
import.asset_idanyOf 1integerWajib dalam induk
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
import.asset_idanyOf 2nullWajib dalam induk—
import.completed_asset_idinteger | nullWajib dalam induk—
import.completed_asset_idanyOf 1integerWajib dalam induk
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
import.completed_asset_idanyOf 2nullWajib dalam induk—
import.asset_purged_atstring | nullWajib dalam induk—
import.asset_purged_atanyOf 1stringWajib dalam induk—
import.asset_purged_atanyOf 2nullWajib dalam induk—
import.source_urlstringWajib dalam induk
  • format: "uri"
import.final_urlstring | nullWajib dalam induk—
import.final_urlanyOf 1stringWajib dalam induk
  • format: "uri"
import.final_urlanyOf 2nullWajib dalam induk—
import.object_keystring | nullWajib dalam induk—
import.object_keyanyOf 1stringWajib dalam induk
  • minLength: 1
import.object_keyanyOf 2nullWajib dalam induk—
import.content_typestring | nullWajib dalam induk—
import.content_typeanyOf 1stringWajib dalam induk
  • minLength: 1
import.content_typeanyOf 2nullWajib dalam induk—
import.byte_sizeinteger | nullWajib dalam induk—
import.byte_sizeanyOf 1integerWajib dalam induk
  • minimum: 0
  • maximum: 9007199254740991
import.byte_sizeanyOf 2nullWajib dalam induk—
import.content_sha256string | nullWajib dalam induk—
import.content_sha256anyOf 1stringWajib dalam induk
  • pattern: "^[0-9a-f]{64}$"
import.content_sha256anyOf 2nullWajib dalam induk—
import.media_probereference | nullWajib dalam induk—
import.media_probeanyOf 1string | number | boolean | null | array | objectWajib dalam induk—
import.media_probeanyOf 1 / anyOf 1stringWajib dalam induk—
import.media_probeanyOf 1 / anyOf 2numberWajib dalam induk—
import.media_probeanyOf 1 / anyOf 3booleanWajib dalam induk—
import.media_probeanyOf 1 / anyOf 4nullWajib dalam induk—
import.media_probeanyOf 1 / anyOf 5arrayWajib dalam induk—
import.media_probe[]anyOf 1 / anyOf 5referenceOpsional / item
  • #/definitions/__schema0
import.media_probeanyOf 1 / anyOf 6objectWajib dalam induk
  • additionalProperties: {"$ref":"#/definitions/__schema0"}
import.media_probe.*anyOf 1 / anyOf 6referenceOpsional / item
  • #/definitions/__schema0
import.media_probeanyOf 2nullWajib dalam induk—
import.error_messagestring | nullWajib dalam induk—
import.error_messageanyOf 1stringWajib dalam induk—
import.error_messageanyOf 2nullWajib dalam induk—
import.created_atstringWajib dalam induk—
import.completed_atstring | nullWajib dalam induk—
import.completed_atanyOf 1stringWajib dalam induk—
import.completed_atanyOf 2nullWajib dalam induk—
assetobject | nullOpsional / item—
assetanyOf 1objectOpsional / item
  • additionalProperties: false
asset.idanyOf 1integer | stringWajib dalam induk—
asset.idanyOf 1 / anyOf 1integerWajib dalam induk
  • minimum: -9007199254740991
  • maximum: 9007199254740991
asset.idanyOf 1 / anyOf 2stringWajib dalam induk—
asset.asset_typeanyOf 1stringWajib dalam induk
  • enum: ["text","image","video","audio"]
asset.asset_urlanyOf 1string | nullWajib dalam induk—
asset.asset_urlanyOf 1 / anyOf 1stringWajib dalam induk—
asset.asset_urlanyOf 1 / anyOf 2nullWajib dalam induk—
assetanyOf 2nullOpsional / item—
JSON Schema lengkap
{
  "type": "object",
  "properties": {
    "import": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "status": {
          "type": "string",
          "enum": [
            "queued",
            "importing",
            "needs_repair",
            "ready",
            "asset_purged",
            "failed"
          ]
        },
        "job_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid"
            },
            {
              "type": "null"
            }
          ]
        },
        "asset_id": {
          "anyOf": [
            {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "completed_asset_id": {
          "anyOf": [
            {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "asset_purged_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "source_url": {
          "type": "string",
          "format": "uri"
        },
        "final_url": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "object_key": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1
            },
            {
              "type": "null"
            }
          ]
        },
        "content_type": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1
            },
            {
              "type": "null"
            }
          ]
        },
        "byte_size": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "content_sha256": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[0-9a-f]{64}$"
            },
            {
              "type": "null"
            }
          ]
        },
        "media_probe": {
          "anyOf": [
            {
              "$ref": "#/definitions/__schema0"
            },
            {
              "type": "null"
            }
          ]
        },
        "error_message": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "created_at": {
          "type": "string"
        },
        "completed_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "id",
        "status",
        "job_id",
        "asset_id",
        "completed_asset_id",
        "asset_purged_at",
        "source_url",
        "final_url",
        "object_key",
        "content_type",
        "byte_size",
        "content_sha256",
        "media_probe",
        "error_message",
        "created_at",
        "completed_at"
      ],
      "additionalProperties": false
    },
    "asset": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "string"
                }
              ]
            },
            "asset_type": {
              "type": "string",
              "enum": [
                "text",
                "image",
                "video",
                "audio"
              ]
            },
            "asset_url": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "id",
            "asset_type",
            "asset_url"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "import"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "definitions": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/definitions/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/definitions/__schema0"
          }
        }
      ]
    }
  }
}

Contoh panggilan alat

Contoh ini menggunakan nilai fiktif yang diperiksa terhadap skema. Ganti ID dengan yang diizinkan bagi Anda, media dengan aset siap, dan tanggal dengan waktu publikasi yang dikonfirmasi. Periksa kelayakan akun sebelum mengirim penulisan. Halaman ini tidak mengirim permintaan API.

{
  "name": "sosoapi_get_asset_import_status",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "import_id": "11111111-1111-4111-8111-111111111111"
  }
}

structuredContent

{
  "import": {
    "id": "11111111-1111-4111-8111-111111111111",
    "status": "queued",
    "job_id": null,
    "asset_id": null,
    "completed_asset_id": null,
    "asset_purged_at": null,
    "source_url": "https://example.com/media.png",
    "final_url": null,
    "object_key": null,
    "content_type": null,
    "byte_size": null,
    "content_sha256": null,
    "media_probe": null,
    "error_message": null,
    "created_at": "example",
    "completed_at": null
  }
}
Instal atau hubungkan MCP