Excel Çalışma Kitabına Dijital İmza Ekleyin – Aspose.Cells Cloud API
Önkoşullar:
Bu uç noktayı çağırmadan önce şunlardan emin olun:
- Aspose Cloud kimlik doğrulaması yoluyla geçerli bir JWT erişim belirteci edinmiş olmanız.
- Hedef çalışma kitabının Aspose Cloud depolama alanınıza yüklenmiş olması.
.pfxveya.p12formatında bir dijital imza dosyasına ve şifresine sahip olmanız.
Bu REST API, bir Excel çalışma kitabına dijital imza ekler.
PostDigitalSignature API
POST https://api.aspose.cloud/v4.0/cells/{name}/digitalsignature
Güvenlik ve Kimlik Doğrulama
Aspose.Cells Cloud API’leri güvenlidir ve JWT belirteci tabanlı kimlik doğrulama gerektirir.
İstek Parametreleri
| Parametre Adı | Tür | Konum | Açıklama |
|---|---|---|---|
| name | string | <code>path</code> |
Çalışma kitabının adı. |
| digitalsignaturefile | string | <code>query</code> |
Dijital imza dosyasının yolu (.pfx veya .p12). |
| password | string | <code>query</code> |
Çalışma kitabının korunmuş olması durumunda şifresi. |
| folder | string | <code>query</code> |
Çalışma kitabının bulunduğu klasör. |
| storageName | string | <code>query</code> |
Kullanılacak depolama hizmetinin adı. |
Not: Dosya adı özel karakterler içeriyorsa, sorgu dizisine eklemeden önce URL kodlaması yapın.
Hata Yönetimi
| HTTP Durum Kodu | Anlam |
|---|---|
| 200 | İmza başarıyla uygulandı. |
| 400 | Geçersiz istek – eksik veya geçersiz parametreler. |
| 401 | Yetkisiz erişim – geçersiz veya süresi dolmuş OAuth belirteci. |
| 403 | Yetki reddedildi – yetersiz izinler veya erişim engellendi. |
| 500 | Sunucu iç hatası – beklenmeyen hata. |
HTTP Durum Kodu Hata Yanıtları
| HTTP Durum Kodu | Kod | Açıklama |
|---|---|---|
| 400 | BadRequest | Eksik veya geçersiz parametreler. |
| 401 | Unauthorized | Geçersiz veya eksik erişim belirteci. |
| 404 | NotFound | Belirtilen çalışma kitabı belirtilen klasör/depolama alanında bulunamadı. |
| 500 | InternalServerError | Beklenmeyen sunucu hatası. |
SDK’larla PostDigitalSignature API Nasıl Kullanılır
PostDigitalSignature API Spesifikasyonu
OpenAPI Spesifikasyonu, genel olarak erişilebilir bir programlama arayüzü tanımlar ve REST etkileşimlerini doğrudan bir web tarayıcısından gerçekleştirmenizi sağlar.
Aspose.Cells web hizmetlerini çağırmak için cURL komut satırı aracını kullanabilirsiniz. Aşağıdaki örnek, API’ye bir isteği göstermektedir:
Yanıt Şeması
API, aşağıdaki alanları içeren bir JSON nesnesi döndürür:
| Alan | Tür | Açıklama |
|---|---|---|
Code |
int | Sonucu belirten HTTP benzeri durum kodu. |
Status |
string | Sonucu açıklayan kısa metin (örneğin, OK). |
SignatureId |
string | Uygulanan dijital imzanın tanımlayıcısı (isteğe bağlı). |
Message |
string | Ek bilgiler veya hata detayları (isteğe bağlı). |
Aspose.Cells Cloud SDK’larını Kullanma
Bir SDK kullanmak entegrasyonu basitleştirir ve tekrarlayan kod miktarını azaltır. Aspose.Cells Cloud SDK’larının tam listesi için lütfen GitHub deposuna göz atın.
Aşağıdaki kod örnekleri, farklı SDK’lar kullanarak Aspose.Cells web hizmetlerini çağırma yöntemini göstermektedir: