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

# SPEKE API v2
<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. Agar sesuai dengan Speke, 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 yang lengkap.

SPEKE menggunakan definisi struktur data DASH Industry Forum Content Protection Information Exchange Format (DASH-IF-CPIX) untuk pertukaran kunci, dengan beberapa batasan. DASH-IF-CPIXmendefinisikan skema untuk menyediakan pertukaran multi-DRM yang dapat diperluas dari platform DRM ke enkripsi. Ini memungkinkan enkripsi konten untuk semua format kemasan bitrate adaptif pada saat kompresi dan pengemasan konten. Format kemasan 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 [CPIX 2.3](https://dashif.org/docs/CPIX2.3/Cpix.html).

Secara keseluruhan, SPEKE v2.0 membawa evolusi berikut dibandingkan dengan SPEKE v1.0:
+ Semua tag dari namespace SPEKE XHTML tidak digunakan lagi demi tag yang setara di namespace CPIX XHTML
+  `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` 
+ Support untuk beberapa kunci konten
+ Mekanisme cross-versioning antara SPEKE dan CPIX
+ Evolusi header HTTP: `X-Speke-Version` header baru, `Speke-User-Agent` header diganti namanya menjadi `X-Speke-User-Agent` 
+ penghentian API detak jantung

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