Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# API SPECE v2.0
<a name="the-speke-api-v2"></a>

Ini adalah REST API untuk Secure Packager dan Encoder Key Exchange (SPEKE) v2. Gunakan spesifikasi ini untuk memberikan perlindungan hak cipta DRM bagi pelanggan yang menggunakan enkripsi. Untuk menjadi SPEKE-compliant, penyedia kunci DRM Anda harus mengekspos REST API yang dijelaskan dalam spesifikasi ini. Enkripsi membuat panggilan API ke penyedia kunci Anda.

**catatan**  
Contoh kode dalam spesifikasi ini hanya untuk tujuan ilustrasi. Anda tidak dapat menjalankan contoh karena mereka bukan bagian dari implementasi SPEKE lengkap.

SPEKE menggunakan definisi struktur data DASH Industry Industry Forum Content Protection Information Exchange Format (DASH-IF-CPIX) untuk pertukaran kunci, dengan beberapa batasan. DASH-IF-CPIX mendefinisikan skema untuk menyediakan pertukaran multi-DRM yang dapat diperluas dari platform DRM ke enkripsi. Ini memungkinkan enkripsi konten untuk semua format pengemasan bitrate adaptif pada saat kompresi dan pengemasan konten. Format pengemasan bitrate adaptif termasuk HLS, DASH, dan MSS.

Dimulai dengan versi 2.0, SPEKE disejajarkan pada versi CPIX tertentu:

Di sisi SPEKE, ini diberlakukan melalui penggunaan header `X-Speke-Version` HTTP, dan di sisi CPIX melalui penggunaan atribut. `CPIX@version` Kurangnya elemen-elemen ini dalam permintaan adalah tipikal alur kerja lama SPEKE v1. Dalam alur kerja SPEKE v2, penyedia kunci diharapkan untuk memproses dokumen CPIX hanya jika mendukung kedua parameter versi.

Untuk informasi rinci tentang format pertukaran, lihat spesifikasi [ DASH Industry Forum ](https://dashif.org/docs/CPIX2.3/Cpix.html) CPIX 2.3.

Secara keseluruhan, SPEKE v2.0 membawa evolusi berikut dibandingkan dengan SPEKE v1.0:
+ Semua tag dari namespace XML SPEKE tidak digunakan lagi demi tag setara di namespace XML CPIX
+  `SPEKE:ProtectionHeader`tidak digunakan lagi dan diganti dengan `CPIX:DRMSystem.SmoothStreamingProtectionHeaderData` 
+  `CPIX:URIExtXKey`, `SPEKE:KeyFormat` dan `SPEKE:KeyFormatVersions` tidak digunakan lagi dan diganti dengan `CPIX:DRMSystem.HLSSignalingData` 
+  `CPIX@id`digantikan oleh `CPIX@contentId` 
+ Atribut CPIX wajib baru:`CPIX@version`, `ContentKey@commonEncryptionScheme` 
+ Elemen CPIX opsional baru: `DRMSystem.ContentProtectionData` 
+ Dukungan untuk beberapa kunci konten
+ Cross-versioning mekanisme antara SPEKE dan CPIX
+ Evolusi header HTTP: `X-Speke-Version` header baru, `Speke-User-Agent` header diganti namanya menjadi `X-Speke-User-Agent` 
+ Penghentian Heartbeat API

Karena spesifikasi SPEKE v1.0 tetap tidak berubah, implementasi yang ada tidak perlu diubah untuk terus mendukung alur kerja SPEKE v1.0.

**Topics**
+ [SPEKE API v2.0 - Kustomisasi dan batasan untuk spesifikasi DASH-IF](speke-constraints-v2.md)
+ [SPEKE API v2.0 - Komponen muatan standar](standard-payload-components-v2.md)
+ [SPEKE API v2.0 - Kontrak enkripsi](encryption-contract-v2.md)
+ [SPEKE API v2.0 - Contoh panggilan metode alur kerja langsung](live-workflow-methods-v2.md)
+ [SPEKE API v2.0 - contoh panggilan metode alur kerja VOD](vod-workflow-method-v2.md)
+ [SPEKE API v2.0 - Enkripsi kunci konten](content-key-encryption-v2.md)
+ [SPEKE API v2.0 - Mengganti pengenal kunci](kid-override-v2.md)