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

Zoeken wordt pas geladen wanneer je het gebruikt. Bekijk hieronder alle categorieën.

MCP-tool

Importstatus van mediabestand ophalen

sosoapi_get_asset_import_status

Lees een import op import_id. Geef voor publicatie include_asset=true mee: een gereed resultaat bevat de geregistreerde media-id, het type en de stabiele asset_url, zodat een aparte get_asset niet nodig is. Wachtende of ontbrekende mediabestanden kunnen niet worden ingepland. Gebruik nooit de bron- of voorbeeld-URL als media-identiteit. Vraag bij stilstand sosoapi_job_status op met job_id; start nooit een dubbele import.

Lezen als Markdown

Profielen en transporten

Profielen: core, full · Transporten: stdio, http

Kies core of full om te bepalen welke tools je client ziet; dit verandert geen machtigingen. Lokale bestandsupload vereist stdio en is niet beschikbaar via HTTP. Stel SOSOAPI_OUTPUT_SCHEMAS=1 in om uitvoerschema's bij detectie op te nemen. Tools geven met en zonder die instelling gestructureerde resultaten terug.

Machtigingen en neveneffecten

Annotaties helpen clients een tool te beschrijven. Elke aanroep controleert nog steeds gebruikersauthenticatie, rol, resourcetoegang en verleende bevoegdheden.

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

Invoervelden

Verplicht betekent verplicht binnen het bovenliggende object en de gekozen variant. Een verplicht onderliggend veld maakt een optioneel bovenliggend object niet verplicht. Onderstaande regels en veldnamen zijn uit het contract gekopieerd.

Invoervelden
Veld / variantType / verplichtBeperkingen
$objectVerplicht in bovenliggend object
  • additionalProperties: false
workspace_idstringVerplicht in bovenliggend object
  • format: "uuid"
import_idstringVerplicht in bovenliggend object
  • format: "uuid"
include_assetbooleanOptioneel / item—
Volledig JSON Schema
{
  "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
}

Gestructureerde uitvoer

Dit schema beschrijft structuredContent in een geslaagd toolresultaat. Het MCP-antwoord bevat ook content en kan isError instellen wanneer een aanroep mislukt. Lees bij publiceren het definitieve berichtresultaat; beschouw een geaccepteerd verzoek of tekstantwoord niet als bevestiging. De gekoppelde API-bewerking beschrijft machtigingen en regels voor opnieuw proberen.

Verplicht betekent verplicht binnen het bovenliggende object en de gekozen variant. Een verplicht onderliggend veld maakt een optioneel bovenliggend object niet verplicht. Onderstaande regels en veldnamen zijn uit het contract gekopieerd.

Gestructureerde uitvoer
Veld / variantType / verplichtBeperkingen
$objectVerplicht in bovenliggend object
  • additionalProperties: false
importobjectVerplicht in bovenliggend object
  • additionalProperties: false
import.idstringVerplicht in bovenliggend object
  • format: "uuid"
import.statusstringVerplicht in bovenliggend object
  • enum: ["queued","importing","needs_repair","ready","asset_purged","failed"]
import.job_idstring | nullVerplicht in bovenliggend object—
import.job_idanyOf 1stringVerplicht in bovenliggend object
  • format: "uuid"
import.job_idanyOf 2nullVerplicht in bovenliggend object—
import.asset_idinteger | nullVerplicht in bovenliggend object—
import.asset_idanyOf 1integerVerplicht in bovenliggend object
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
import.asset_idanyOf 2nullVerplicht in bovenliggend object—
import.completed_asset_idinteger | nullVerplicht in bovenliggend object—
import.completed_asset_idanyOf 1integerVerplicht in bovenliggend object
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
import.completed_asset_idanyOf 2nullVerplicht in bovenliggend object—
import.asset_purged_atstring | nullVerplicht in bovenliggend object—
import.asset_purged_atanyOf 1stringVerplicht in bovenliggend object—
import.asset_purged_atanyOf 2nullVerplicht in bovenliggend object—
import.source_urlstringVerplicht in bovenliggend object
  • format: "uri"
import.final_urlstring | nullVerplicht in bovenliggend object—
import.final_urlanyOf 1stringVerplicht in bovenliggend object
  • format: "uri"
import.final_urlanyOf 2nullVerplicht in bovenliggend object—
import.object_keystring | nullVerplicht in bovenliggend object—
import.object_keyanyOf 1stringVerplicht in bovenliggend object
  • minLength: 1
import.object_keyanyOf 2nullVerplicht in bovenliggend object—
import.content_typestring | nullVerplicht in bovenliggend object—
import.content_typeanyOf 1stringVerplicht in bovenliggend object
  • minLength: 1
import.content_typeanyOf 2nullVerplicht in bovenliggend object—
import.byte_sizeinteger | nullVerplicht in bovenliggend object—
import.byte_sizeanyOf 1integerVerplicht in bovenliggend object
  • minimum: 0
  • maximum: 9007199254740991
import.byte_sizeanyOf 2nullVerplicht in bovenliggend object—
import.content_sha256string | nullVerplicht in bovenliggend object—
import.content_sha256anyOf 1stringVerplicht in bovenliggend object
  • pattern: "^[0-9a-f]{64}$"
import.content_sha256anyOf 2nullVerplicht in bovenliggend object—
import.media_probereference | nullVerplicht in bovenliggend object—
import.media_probeanyOf 1string | number | boolean | null | array | objectVerplicht in bovenliggend object—
import.media_probeanyOf 1 / anyOf 1stringVerplicht in bovenliggend object—
import.media_probeanyOf 1 / anyOf 2numberVerplicht in bovenliggend object—
import.media_probeanyOf 1 / anyOf 3booleanVerplicht in bovenliggend object—
import.media_probeanyOf 1 / anyOf 4nullVerplicht in bovenliggend object—
import.media_probeanyOf 1 / anyOf 5arrayVerplicht in bovenliggend object—
import.media_probe[]anyOf 1 / anyOf 5referenceOptioneel / item
  • #/definitions/__schema0
import.media_probeanyOf 1 / anyOf 6objectVerplicht in bovenliggend object
  • additionalProperties: {"$ref":"#/definitions/__schema0"}
import.media_probe.*anyOf 1 / anyOf 6referenceOptioneel / item
  • #/definitions/__schema0
import.media_probeanyOf 2nullVerplicht in bovenliggend object—
import.error_messagestring | nullVerplicht in bovenliggend object—
import.error_messageanyOf 1stringVerplicht in bovenliggend object—
import.error_messageanyOf 2nullVerplicht in bovenliggend object—
import.created_atstringVerplicht in bovenliggend object—
import.completed_atstring | nullVerplicht in bovenliggend object—
import.completed_atanyOf 1stringVerplicht in bovenliggend object—
import.completed_atanyOf 2nullVerplicht in bovenliggend object—
assetobject | nullOptioneel / item—
assetanyOf 1objectOptioneel / item
  • additionalProperties: false
asset.idanyOf 1integer | stringVerplicht in bovenliggend object—
asset.idanyOf 1 / anyOf 1integerVerplicht in bovenliggend object
  • minimum: -9007199254740991
  • maximum: 9007199254740991
asset.idanyOf 1 / anyOf 2stringVerplicht in bovenliggend object—
asset.asset_typeanyOf 1stringVerplicht in bovenliggend object
  • enum: ["text","image","video","audio"]
asset.asset_urlanyOf 1string | nullVerplicht in bovenliggend object—
asset.asset_urlanyOf 1 / anyOf 1stringVerplicht in bovenliggend object—
asset.asset_urlanyOf 1 / anyOf 2nullVerplicht in bovenliggend object—
assetanyOf 2nullOptioneel / item—
Volledig JSON Schema
{
  "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"
          }
        }
      ]
    }
  }
}

Voorbeeld van een toolaanroep

Deze voorbeelden gebruiken fictieve waarden die tegen de schema's zijn gecontroleerd. Vervang IDs door toegestane IDs, media door gereedstaande bestanden en datums door je bevestigde publicatietijd. Controleer accountgeschiktheid vóór een schrijfhandeling. Deze pagina verstuurt geen API-verzoeken.

{
  "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
  }
}
Installeer of verbind MCP