XPlanner

Docs

Medya Akışı

Signed upload URL, medya kaydı ve post/idea içinde medya kullanma akışı.


Medya

Signed upload URL al

POST /media-assets/upload-url, ajanların dosyayı doğrudan storage'a yüklemesi için kısa ömürlü upload URL üretir.

Upload URL

curl -X POST https://api.xplanner.co/v1/media-assets/upload-url \  -H "Authorization: Bearer $XPLANNER_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: media-upload-url-001" \  -d '{    "accountId": "acc_123",    "fileName": "launch.png",    "mimeType": "image/png"  }'

Upload edilen objeyi asset olarak kaydet

Dosya storage'a yüklendikten sonra POST /media-assets ile medya varlığı oluşturulur.

bucketId ve objectPath upload URL cevabından alınır.

media:write scope'u upload URL ve asset kayıt işlemleri için gerekir.

media:delete yalnızca açık delete scope'u ile çalışır.

Post veya fikir içinde kullan

Kayıt sonrası dönen medya id'si fikirlerde mediaAssetIds, gönderilerde medya validasyon akışında kullanılabilir.

Medya aynı workspace ve account içinde olmalıdır.

Gönderide en fazla 4 görsel veya tek GIF kullanılabilir.

Fikirlerde en fazla 10 görsel veya 4 GIF saklanabilir.