Bir dosyayı herkese açık bir bağlantıda yayımla
Dosyayı oturum açmadan açan, herkese açık bir indirme bağlantısı oluşturur; bir e-postadan ya da bir web sayfasından başvurulan bir görsel veya belge için.
Gerçek çağrıyı kendi anahtarınızla çalışma alanınıza karşı çalıştırır.
POST /files/{id}/links
Dosyayı oturum açmadan açan, herkese açık bir indirme bağlantısı oluşturur; bir e-postadan ya da bir web sayfasından başvurulan bir görsel veya belge için.
Örnek
files:write gerekir. Gövde isteğe bağlıdır. domain, bağlantıyı dosya ana makinesi sunacak alan adını belirtir; örneğin files.acme.com için acme.com. Yanıt, yeni bağlantıyla birlikte bir 201 olur.
curl -X POST "$OE/files/file_6bb640f5b99e47deb758f1f5/links" -H "$AUTH" -H 'content-type: application/json' -d '{ "domain": "acme.com" }'{ "object": "file_link", "id": "fshr_4d7a0c2e9b16f3584a2c7e90", "fileId": "file_6bb640f5b99e47deb758f1f5", "filename": "invoice-0912.pdf", "mimeType": "application/pdf", "sizeBytes": 184233, "host": "files.acme.com", "url": "https://files.acme.com/f/8c2e…/invoice-0912.pdf", "downloads": 0, "lastDownloadAt": null, "revokedAt": null, "createdAt": "2026-09-24T10:02:17.000Z"}Bağlantı, o alan adının bir dosya ana makinesi varsa domain değerinin dosya ana makinesinde sunulur. Bu değer verilmezse ya da o alan adının dosya ana makinesi yoksa, dosyanın ait olduğu adresin dosya ana makinesinde, o da yoksa API adresinde sunulur.
Bir iletiyle gelen ya da giden bir dosya önce herkese açık depolamaya kopyalanır. Bir program ya da betik 422 file_unshareable ile reddedilir.
Her çağrı kendi indirme sayısına sahip yeni bir bağlantı oluşturur; bu yüzden kaybolan bir yanıttan sonra yeniden denemek ikinci bir bağlantı oluşturur. Tekrar denemeden önce bağlantıları GET /files/{id}/links ile listeleyin.
Bir bağlantı, iptal edilene ya da dosya silinene kadar çalışmaya devam eder.