Open API - Dokumentation zur Medienanalyse

01 · Schnellstart

Analyseanfrage senden

Füge den API-Schlüssel zum Header hinzu und sende eine öffentliche URL im JSON-Inhalt.

curl -X POST https://api.videotool.cc/openapi/parse \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://..."}'

02 · Authentifizierung

Mit API-Schlüssel authentifizieren

Sende X-API-Key bei jeder Anfrage. Der Schlüssel kann in der Konsole verwaltet werden.

X-API-KeyYOUR_API_KEY

Bewahre API-Schlüssel auf dem Server auf und veröffentliche sie nicht in Apps oder Repositories.

03 · Endpoint

Verfügbarer Endpoint

POST/openapi/parseEinzelne URL

Eine öffentliche Medien-URL analysieren

Sende eine öffentliche Beitrags- oder Video-URL. Nach nutzbaren Ergebnissen wird ein Guthaben berechnet.

url string · required Öffentliche Beitrags- oder Video-URL

04 · Antwort

Erfolgreiche Antwort

Ein erfolgreicher Aufruf liefert ParseResult in AjaxResult mit Video-, Bild-, Audio- und Textressourcen.

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "resultCode": 0,
    "hasResource": true,
    "resourceType": 200,
    "descList": ["..."],
    "imgList": [],
    "videoList": [],
    "audioList": []
  }
}

05 · Fehler

Geschäftsfehlercodes

code	Bedeutung	Kosten
`400`	URL fehlt oder ist ungültig	Kostenfrei
`401`	API-Schlüssel fehlt, ist ungültig oder deaktiviert	Kostenfrei
`403`	Nicht genügend Guthaben	Kostenfrei
`422`	Keine nutzbare Ressource zurückgegeben	Kostenfrei
`500`	Fehler des Analysedienstes	Kostenfrei

06 · Abrechnung

Nur erfolgreiche Ergebnisse werden berechnet

1Guthaben bei nutzbaren Ergebnissen berechnet

0Guthaben bei Fehlern oder leeren Ergebnissen berechnet

Aktueller Umfang

Open API bietet nur POST /openapi/parse für eine URL. Keine Batch-, Capabilities-, Idempotenz-Cache- oder Rate-Limit-Endpoints.

Medienanalyse über einen Endpoint integrieren