POST
/media-assets
media:write
Header'lar
Authorization
*string
API anahtarı. Format: Bearer xpl_live_...
Idempotency-Key
*string
Aynı yazma isteğinin güvenle tekrar denenmesi için 1-255 karakterlik benzersiz değer.
Content-Type
string
JSON body gönderirken application/json kullan.
Body
socialSetId
*string
Planner medyasının bağlanacağı Sosyal Set kimliği.
bucketId
*string
Upload URL cevabındaki bucketId.
objectPath
*string
Upload URL cevabındaki objectPath.
mediaType
*string
image veya gif.
altText
string
Alt text. En fazla 1000 karakter.
Cevaplar
201
Medya varlığı kaydedildi.
cURL
curl -X POST https://api.xplanner.co/v1/media-assets \ -H "Authorization: Bearer $XPLANNER_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: media-register-001" \ -d '{ "socialSetId": "set_123", "bucketId": "media", "objectPath": "wrk_123/set_123/api/launch.png", "mediaType": "image", "mimeType": "image/png", "sizeBytes": 245000, "altText": "Ürün ekran görüntüsü" }'Cevap
{ "data": { "id": "media_123", "workspaceId": "wrk_123", "socialSetId": "set_123", "bucketId": "media", "objectPath": "wrk_123/set_123/api/launch.png", "mediaType": "image", "mimeType": "image/png", "sizeBytes": 245000, "altText": "Ürün ekran görüntüsü", "createdAt": "2026-05-15T09:00:00.000Z", "updatedAt": "2026-05-15T09:00:00.000Z" }, "requestId": "req_123"}