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

Die Suche lädt erst bei Nutzung. Durchsuche unten alle Kategorien.

Medien und Assets

Asset-Importstatus abrufen

Lies einen Import anhand von import_id. Übergib zum Veröffentlichen include_asset=true: Ein ready-Ergebnis enthält registrierte Asset-id, kind und stabile asset_url und vermeidet ein separates get_asset. Ausstehende oder fehlende Assets lassen sich nicht planen. Nutze niemals Quell- oder Vorschau-URL als Medienidentität. Lies bei Stillstand sosoapi_job_status mit job_id; starte niemals einen doppelten Import.

POST /assets-api/imports/status

Vertrag geprüft: · sha256:563d2d581da0ad29

Als Markdown lesenÖffentlichen Vertrag herunterladenOpenAPI herunterladen

Überblick

Lies einen Import anhand von import_id. Übergib zum Veröffentlichen include_asset=true: Ein ready-Ergebnis enthält registrierte Asset-id, kind und stabile asset_url und vermeidet ein separates get_asset. Ausstehende oder fehlende Assets lassen sich nicht planen. Nutze niemals Quell- oder Vorschau-URL als Medienidentität. Lies bei Stillstand sosoapi_job_status mit job_id; starte niemals einen doppelten Import.

Eine erfolgreiche HTTP-Antwort kann Annahme statt Abschluss bedeuten. Speichere bei Hintergrundarbeit die ID und prüfe dieselbe Operation bis zum Abschluss. Geplante oder angenommene Beiträge gelten erst nach Plattformbestätigung als veröffentlicht; ein Client-Timeout klärt das Ergebnis nicht.

Authentifizierung und Berechtigungen

Akzeptierte Zugangsdatenklassen
user_session, delegated_oauth, personal_access_token
Delegierte Funktion
agent:operate
Minimale Workspace-Rolle
viewer
Zugriffsumfang
Ressourcen, auf die dieser Nutzer zugreifen darf
Zustimmung für alle Workspaces erforderlich
Nein
Ändert Zustand
Nein
Nach Abschluss der Operation
synchronous_http_response

Ein Token nutzt nur Eigentümerrechte. Jede Anfrage prüft Workspace-Mitgliedschaft, Ressourceneigentum, gewählte Workspaces und Funktionen. core und full ändern sichtbare Tools; sie erteilen keinen Zugriff.

Anfragefelder

Erforderlich bedeutet innerhalb des übergeordneten Objekts und gewählten Zweigs erforderlich. Ein erforderliches Kind macht kein optionales Elternobjekt erforderlich. Regeln und Feldnamen unten stammen aus dem Vertrag.

Anfragefelder
Feld / VarianteTyp / erforderlichEinschränkungen
$objectIm Elternobjekt erforderlich
  • additionalProperties: false
workspace_idstringIm Elternobjekt erforderlich
  • 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)$"
import_idstringIm Elternobjekt erforderlich
  • 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)$"
include_assetbooleanOptional / Element—
Vollständiges JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "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)$"
    },
    "import_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)$"
    },
    "include_asset": {
      "type": "boolean"
    }
  },
  "required": [
    "workspace_id",
    "import_id"
  ],
  "additionalProperties": false
}

Antwort und Abschluss

HTTP-Erfolgsstatus: 200. Wenn die Operation abgeschlossen ist: synchronous_http_response.

Eine erfolgreiche HTTP-Antwort kann Annahme statt Abschluss bedeuten. Speichere bei Hintergrundarbeit die ID und prüfe dieselbe Operation bis zum Abschluss. Geplante oder angenommene Beiträge gelten erst nach Plattformbestätigung als veröffentlicht; ein Client-Timeout klärt das Ergebnis nicht.

Erforderlich bedeutet innerhalb des übergeordneten Objekts und gewählten Zweigs erforderlich. Ein erforderliches Kind macht kein optionales Elternobjekt erforderlich. Regeln und Feldnamen unten stammen aus dem Vertrag.

Antwort und Abschluss
Feld / VarianteTyp / erforderlichEinschränkungen
$objectIm Elternobjekt erforderlich—
importobjectIm Elternobjekt erforderlich—
import.idstringIm Elternobjekt erforderlich
  • 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)$"
import.statusstringIm Elternobjekt erforderlich
  • enum: ["queued","importing","needs_repair","ready","asset_purged","failed"]
import.job_idstring | nullIm Elternobjekt erforderlich—
import.job_idanyOf 1stringIm Elternobjekt erforderlich
  • 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)$"
import.job_idanyOf 2nullIm Elternobjekt erforderlich—
import.asset_idinteger | nullIm Elternobjekt erforderlich—
import.asset_idanyOf 1integerIm Elternobjekt erforderlich
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
import.asset_idanyOf 2nullIm Elternobjekt erforderlich—
import.completed_asset_idinteger | nullIm Elternobjekt erforderlich—
import.completed_asset_idanyOf 1integerIm Elternobjekt erforderlich
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
import.completed_asset_idanyOf 2nullIm Elternobjekt erforderlich—
import.asset_purged_atstring | nullIm Elternobjekt erforderlich—
import.asset_purged_atanyOf 1stringIm Elternobjekt erforderlich—
import.asset_purged_atanyOf 2nullIm Elternobjekt erforderlich—
import.source_urlstringIm Elternobjekt erforderlich
  • format: "uri"
import.final_urlstring | nullIm Elternobjekt erforderlich—
import.final_urlanyOf 1stringIm Elternobjekt erforderlich
  • format: "uri"
import.final_urlanyOf 2nullIm Elternobjekt erforderlich—
import.object_keystring | nullIm Elternobjekt erforderlich—
import.object_keyanyOf 1stringIm Elternobjekt erforderlich
  • minLength: 1
import.object_keyanyOf 2nullIm Elternobjekt erforderlich—
import.content_typestring | nullIm Elternobjekt erforderlich—
import.content_typeanyOf 1stringIm Elternobjekt erforderlich
  • minLength: 1
import.content_typeanyOf 2nullIm Elternobjekt erforderlich—
import.byte_sizeinteger | nullIm Elternobjekt erforderlich—
import.byte_sizeanyOf 1integerIm Elternobjekt erforderlich
  • minimum: 0
  • maximum: 9007199254740991
import.byte_sizeanyOf 2nullIm Elternobjekt erforderlich—
import.content_sha256string | nullIm Elternobjekt erforderlich—
import.content_sha256anyOf 1stringIm Elternobjekt erforderlich
  • pattern: "^[0-9a-f]{64}$"
import.content_sha256anyOf 2nullIm Elternobjekt erforderlich—
import.media_probereference | nullIm Elternobjekt erforderlich—
import.media_probeanyOf 1string | number | boolean | null | array | objectIm Elternobjekt erforderlich—
import.media_probeanyOf 1 / anyOf 1stringIm Elternobjekt erforderlich—
import.media_probeanyOf 1 / anyOf 2numberIm Elternobjekt erforderlich—
import.media_probeanyOf 1 / anyOf 3booleanIm Elternobjekt erforderlich—
import.media_probeanyOf 1 / anyOf 4nullIm Elternobjekt erforderlich—
import.media_probeanyOf 1 / anyOf 5arrayIm Elternobjekt erforderlich—
import.media_probe[]anyOf 1 / anyOf 5referenceOptional / Element
  • #/$defs/__schema0
import.media_probeanyOf 1 / anyOf 6objectIm Elternobjekt erforderlich
  • additionalProperties: {"$ref":"#/$defs/__schema0"}
import.media_probe.*anyOf 1 / anyOf 6referenceOptional / Element
  • #/$defs/__schema0
import.media_probeanyOf 2nullIm Elternobjekt erforderlich—
import.error_messagestring | nullIm Elternobjekt erforderlich—
import.error_messageanyOf 1stringIm Elternobjekt erforderlich—
import.error_messageanyOf 2nullIm Elternobjekt erforderlich—
import.created_atstringIm Elternobjekt erforderlich—
import.completed_atstring | nullIm Elternobjekt erforderlich—
import.completed_atanyOf 1stringIm Elternobjekt erforderlich—
import.completed_atanyOf 2nullIm Elternobjekt erforderlich—
assetobject | nullOptional / Element—
assetanyOf 1objectOptional / Element—
asset.idanyOf 1integer | stringIm Elternobjekt erforderlich—
asset.idanyOf 1 / anyOf 1integerIm Elternobjekt erforderlich
  • minimum: -9007199254740991
  • maximum: 9007199254740991
asset.idanyOf 1 / anyOf 2stringIm Elternobjekt erforderlich—
asset.asset_typeanyOf 1stringIm Elternobjekt erforderlich
  • enum: ["text","image","video","audio"]
asset.asset_urlanyOf 1string | nullIm Elternobjekt erforderlich—
asset.asset_urlanyOf 1 / anyOf 1stringIm Elternobjekt erforderlich—
asset.asset_urlanyOf 1 / anyOf 2nullIm Elternobjekt erforderlich—
assetanyOf 2nullOptional / Element—
Vollständiges JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "import": {
      "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)$"
        },
        "status": {
          "type": "string",
          "enum": [
            "queued",
            "importing",
            "needs_repair",
            "ready",
            "asset_purged",
            "failed"
          ]
        },
        "job_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"
            }
          ]
        },
        "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": "#/$defs/__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"
      ]
    },
    "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"
          ]
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "import"
  ],
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

Fehler und sichere Wiederholungen

Prüfe HTTP-Status und Antwortinhalt. Ein 400-Validierungsfehler kann einen ZodError enthalten; Handler-Fehler verwenden die Felder error, message und code. Bewahre request_id oder x-request-id zur Diagnose ohne Zugangsdaten auf. Behebe 401/403-Zugriffsfehler vor einem erneuten Versuch und beachte Retry-After bei 429. Ist ein Schreibvorgang ungewiss oder liefert 5xx, lies zuerst das bestehende Ergebnis. Verwende einen Idempotenzschlüssel nur wieder, wo dies unterstützt wird; Wiederholungen unterscheiden sich je nach Operation und garantieren keine genau einmalige Zustellung.

Anleitung zur Fehlerbehebung

Beispiele

Diese Beispiele nutzen anhand der Schemas geprüfte fiktive Werte. Ersetze IDs durch autorisierte IDs, Medien durch bereite Assets und Daten durch bestätigte Veröffentlichungszeiten. Prüfe Kontoeignung vor Schreibvorgängen. Diese Seite sendet keine API-Anfragen.

Setze SOSOAPI_ACCESS_TOKEN auf deinem Server auf akzeptierte Zugangsdaten dieser Operation und halte es aus Browsercode heraus. Für Agenten nutze sosoapi auth login zur Browseranmeldung und lass die CLI Zugangsdaten erneuern.

request.json

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

cURL

curl --request POST \
  "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/assets-api/imports/status" \
  -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/assets-api/imports/status", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
  body: JSON.stringify({
  "workspace_id": "11111111-1111-4111-8111-111111111111",
  "import_id": "11111111-1111-4111-8111-111111111111"
})
});
const result = await response.json();
// Check response.ok, the operation-specific body and completion state before continuing.

CLI

npx sosoapi api post /assets-api/imports/status < request.json

Synthetisches Antwortbeispiel

{
  "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
  }
}

MCP: sosoapi_get_asset_import_status

Alle API-OperationenAuthentifizierung und Berechtigungen