Aspose.Cells Cloud API Kullanarak Excel Çalışma Kitabını Koruma

Bu REST API, bir Excel çalışma kitabını korur; böylece Aspose.Cells Cloud kullanarak bir Excel çalışma kitabını şifre ve koruma seçenekleriyle güvenli bir şekilde korumanızı sağlar.

PostProtectDocument API

POST https://api.aspose.cloud/v3.0/cells/{name}/protection

Güvenlik ve Kimlik Doğrulama

Aspose.Cells Cloud API’leri güvenlidir ve JWT belirteci tabanlı kimlik doğrulama gerektirir.

Sorgu Parametreleri

Parametre Adı Tür Açıklama
folder string Kaynak çalışma kitabını içeren klasör. (isteğe bağlı)
storageName string Depolama konumunun adı. (isteğe bağlı; varsayılan = “Default”)

İstek Gövdesi Parametreleri

Parametre Adı Tür Açıklama
protection WorkbookProtectionRequest Çalışma kitabının koruma ayarlarını tanımlayan nesne.

WorkbookProtectionRequest

Parametre Adı Tür Açıklama
ProtectionType string Uygulanacak koruma türü. İzin verilen değerler (büyük/küçük harf duyarsız): ALL, CONTENTS, NONE, OBJECTS, SCENARIOS, STRUCTURE, WINDOWS.
Password string Koruma için ayarlanacak isteğe bağlı şifre.

Yanıt

{
  "Status":"OK",
  "Code":200
}

HTTP Durum Kodları

Kod Anlam Açıklama
200 OK Filtre başarıyla uygulandı; yanıt işlem detaylarını içerir.
400 Bad Request Eksik veya geçersiz parametreler (örneğin, desteklenmeyen dosya türü).
401 Unauthorized Geçersiz veya eksik JWT belirteci.
413 Payload Too Large Yüklenen dosya boyut sınırını aşıyor.
500 Internal Server Error Beklenmeyen sunucu hatası.

PostProtectDocument API’yi SDK’larla Nasıl Kullanılır

Ön Gereksinimler

API’yi çağırmadan önce aşağıdaki adımları tamamladığınızdan emin olun:

  • JWT erişim belirteci edinin, güvenlik bölümünde açıklanan kimlik doğrulama akışını kullanarak.
  • Çalışma kitabını Aspose Cloud depolama alanınıza yükleyin veya hedef klasörde zaten mevcut olduğunu doğrulayın.
  • Depo adını (belirtilmezse varsayılan “Default”) ve korumak istediğiniz tam dosya adını bilmelisiniz.

PostProtectDocument API Spesifikasyonu

OpenAPI Spesifikasyonu, herkese açık bir programlama arayüzü tanımlar ve REST etkileşimlerini doğrudan bir web tarayıcısından gerçekleştirmenize olanak tanır.

Örnek: cURL ile Çalışma Kitabını Koruma

  1. Ön Gereksinimler / Kimlik Doğrulama bölümünde açıklanan şekilde bir erişim belirteci edinin.

  2. İsteği yürütün:

    curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/protection?folder=MyFolder&storageName=MyStorage" \
     -H "accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <access_token>" \
     -d '{ "ProtectionType": "ALL", "Password": "aspose" }'

    Yanıt, korumanın başarıyla tamamlandığını onaylayan bir durum nesnesi içerir.

Aspose.Cells Cloud SDK’larını Kullanma

Bir SDK kullanmak, Aspose.Cells Cloud ile geliştirme yapmanın en hızlı yoludur. SDK, düşük seviyeli detayları soyutlayarak iş mantığınıza odaklanmanızı sağlar. Aspose.Cells Cloud SDK’larının tam listesi için GitHub Deposu‘na bakın.

Aşağıdaki kod örnekleri, çeşitli SDK’ları kullanarak Aspose.Cells web hizmetlerini nasıl çağıracağınızı göstermektedir:

Örnek Tam Yanıt

{
  "Status": "OK",
  "Code": 200,
  "Workbook": {
    "Name": "test.xlsx",
    "Path": "/MyFolder/test.xlsx",
    "Protection": {
      "ProtectionType": "ALL",
      "Password": true
    }
  }
}
Aspose.Cells Cloud API ile Excel Çalışma Kitabını Şifreleyin – Hızlı cURL ve SDK Örnekleri Excel Çalışma Kitabına Dijital İmza Ekleyin