API-Referenz

Videos

Personalisierte Videos je Lead

Personalisiertes Video eines Leads

GET/v1/leads/{id}/video

Scope read:assetsRecht: Outreach Plattformliest

Das aktuelle personalisierte Video des Leads mit Vorschaubild, wie es das Lead-Panel zeigt, dazu der Stand: processing, solange ein Video erstellt wird (auch aus dem Impact Studio oder einer Kampagne), failed, wenn die letzte Erstellung ohne Video gescheitert ist. job_id führt zum Auftrag (GET /v1/jobs/{id}). Kostet nichts.

Pfad-Parameter

idstring (uuid)Pflicht
ID des Leads

Felder der Antwort

lead_idstring (uuid)
ID des Leads
statusstring
none: kein Video. processing: ein Video wird gerade erstellt (video_url kann noch das vorige zeigen). ready: Video vorhanden. failed: die letzte Erstellung ist gescheitert, es gibt kein Video
none processing ready failed
video_urlstring, kann null sein
Das personalisierte Video (MP4), wie im Lead-Panel
thumbnail_urlstring, kann null sein
Vorschaubild des Videos
processing_started_atstring (date-time), kann null sein
Beginn der laufenden Erstellung, sonst null
job_idstring (uuid), kann null sein
Laufender, sonst neuester Video-Auftrag für diesen Lead (GET /v1/jobs/{id}). null, wenn das Video nicht über das Impact Studio, eine Kampagne oder die API entstand

Mögliche Fehler

400 VALIDATION_ERROR401 INVALID_API_KEY402 PLAN_REQUIRED403 SCOPE_MISSING404 NOT_FOUND429 RATE_LIMITED

curl -X GET "https://api.dealsky.io/functions/v1/api/v1/leads/5b0c1e7a-3f1d-4a52-9c1e-8a7d2b6f4e10/video" \
  -H "X-API-Key: $DEALSKY_API_KEY"

const res = await fetch("https://api.dealsky.io/functions/v1/api/v1/leads/5b0c1e7a-3f1d-4a52-9c1e-8a7d2b6f4e10/video", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.DEALSKY_API_KEY,
  },
});
const { ok, data, error } = await res.json();

import os, requests

res = requests.request(
    "GET",
    "https://api.dealsky.io/functions/v1/api/v1/leads/5b0c1e7a-3f1d-4a52-9c1e-8a7d2b6f4e10/video",
    headers={"X-API-Key": os.environ["DEALSKY_API_KEY"]},
)
print(res.json())

Antwort 200

{
  "ok": true,
  "data": {
    "lead_id": "5b0c1e7a-3f1d-4a52-9c1e-8a7d2b6f4e10",
    "status": "ready",
    "video_url": "https://cdn.dealskycloud.com/tenants/9a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d/personalized/5b0c1e7a-3f1d-4a52-9c1e-8a7d2b6f4e10/video_1760778887103.mp4",
    "thumbnail_url": "https://cdn.dealskycloud.com/tenants/9a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d/personalized/5b0c1e7a-3f1d-4a52-9c1e-8a7d2b6f4e10/thumbnail_1760778887103.jpg",
    "processing_started_at": null,
    "job_id": "3f9c2a71-5d4e-4b8a-9c1f-7e6d5a4b3c21"
  },
  "meta": {
    "request_id": "req_7f3a…"
  }
}