Medya yükle


POST https://app.apsilo.com/api/public/v1/media

multipart/form-data ile dosya (file alanı, isteğe bağlı name; en çok 100 MB) veya JSON {url, name?} ile adresten yükleme. Tür, boyut ve depolama kotası denetlenir. Dönen id mesaj, şablon başlığı, e-posta eki, kampanya ve sosyal gönderilerde kullanılır.

Gerekli kapsam: media:write

Parametreler

Parametre	Yer	Tip	Gereklilik	Açıklama
`Idempotency-Key`	başlık	string	isteğe bağlı	İsteğe özgü benzersiz değer (1–255 yazdırılabilir ASCII; ör. UUID). Aynı anahtar + aynı yol ve gövde 24 saat içinde kaydedilmiş yanıtı döner (`Idempotent-Replayed: true`); farklı gövde veya işlenmekte olan istek `409 IDEMPOTENCY_CONFLICT`. Hata yanıtları saklanmaz.
`X-Request-Id`	başlık	string	isteğe bağlı	İsteğe bağlı istek kimliğiniz (8–100 karakter: harf, rakam, `._:-`); yanıtta aynen döner ve kayıtlara işlenir.

İstek gövdesi

Alan	Tip	Gereklilik	Açıklama
`url`	string (uri)	zorunlu	İndirilecek herkese açık http(s) adresi
`name`	string	isteğe bağlı	Dosya adı


{
  "url": "https://cdn.demokahve.com/kampanya/ekim.jpg",
  "name": "ekim-kampanyasi.jpg"
}

Yanıtlar

Durum	Açıklama
`201`	Medya oluşturuldu
`401`	Kimlik doğrulanamadı. Olası kodlar: `API_KEY_INVALID`, `API_KEY_REVOKED`, `API_KEY_EXPIRED`.
`403`	Erişim reddedildi. Olası kodlar: `FEATURE_NOT_LICENSED`, `API_SCOPE_MISSING`, `IP_NOT_ALLOWED`, `LICENSE_EXPIRED`, `LICENSE_NOT_FOUND`, `FORBIDDEN`.
`409`	Çakışma. Olası kodlar: `CONFLICT`, `IDEMPOTENCY_CONFLICT`, `MEDIA_IN_USE`, `SOCIAL_APPROVAL_REQUIRED`, `SOCIAL_POST_NOT_EDITABLE`.
`413`	Gövde çok büyük. Olası kodlar: `PAYLOAD_TOO_LARGE`.
`415`	Desteklenmeyen içerik türü. Olası kodlar: `UNSUPPORTED_MEDIA_TYPE`.
`422`	İşlenemeyen istek. Olası kodlar: `VALIDATION_FAILED`, `MESSAGING_WINDOW_CLOSED`, `CHANNEL_ACCOUNT_MISSING`, `CONTACT_BLOCKED`, `STORAGE_LIMIT_REACHED`, `SOCIAL_POST_INVALID`, `SOCIAL_PLATFORM_UNAVAILABLE`.
`429`	Hız sınırı aşıldı. Olası kodlar: `RATE_LIMITED`.
`500`	Sunucu hatası. Olası kodlar: `INTERNAL`.

Örnek yanıt (201)


{
  "data": {
    "id": "0b9e4c1a-6f2d-4a7b-9c3e-000000000042",
    "name": "ekim-kampanyasi.jpg",
    "kind": "image",
    "mimeType": "image/jpeg",
    "sizeBytes": 482113
  }
}