Bayi API'de kod şifreleme nedir, kodları kendi anahtarımla şifreli nasıl alırım?

Kod şifreleme, API ile aldığın e-pin kodlarına ikinci bir kilit ekler. Açık anahtarını Oyuneks'e verirsin, gizli anahtar yalnız senin sunucunda durur ve Oyuneks'e hiç gelmez. Böylece API anahtarın çalınsa bile kodlar okunamaz.

Nasıl açılır?

1. Hesabında iki adımlı doğrulamayı aç; kod şifreleme ayarı bu olmadan değiştirilemez.
2. Bayi Paneli'nde Entegrasyon > API anahtarları ekranını aç ve Kod şifreleme kartına in.
3. Anahtar üret'e bas. Anahtar çifti senin tarayıcında üretilir.
4. Gizli anahtarı indir (oyuneks-gizli-anahtar.pem) ile dosyayı indir, API'yi çağıran sunucuna koy ve güvenli bir yerde sakla. Bu dosya bir daha üretilemez.
5. Dosyayı güvenli bir yere kaydettim kutusunu işaretle ve Açık anahtarı kaydet'e bas.
6. Çifti doğrula ile sakladığın gizli anahtar dosyasını seç. Dosya yalnız tarayıcında okunur, sunucuya gönderilmez; "Çift doğru" yazarsa anahtarın doğru.

Kendi anahtarını kullanmak istersen kartta Kendi ürettiğim açık anahtarı yapıştırayım bölümünü aç ve yalnız açık anahtarı (BEGIN PUBLIC KEY) yapıştır. Anahtar 2048 ile 8192 bit arası RSA olmalı; önerilen 3072 bit.

Düz kodu kapatma

• Açık anahtarı kaydettiğin andan itibaren API yanıtlarında her kodun yanında şifreli alan (encrypted) da gelir. Mevcut entegrasyonun bozulmaz, düz kod da gelmeye devam eder.
• Entegrasyonun şifreli alanı çözebildiğinde Düz kodu kapat'a bas. Bundan sonra API kodu yalnız şifreli gönderir; asıl koruma bu adımla başlar.
• Düz kodu kapatmak için önce çifti doğrulaman gerekir. İstediğin zaman Düz kodu aç ile geri açabilirsin.
• Anahtarı kaldır dersen API kodları yeniden şifresiz verir.

Bilmen gerekenler

• Şifreleme yalnız API ve MCP yanıtlarını etkiler; bayi panelindeki kod ekranı ve panelden indirdiğin dosyalar değişmez.
• Çözme kodunu gerçek sipariş beklemeden GET /bayi-api/v1/encryption ucundaki test zarfıyla deneyebilirsin; test anahtarıyla verilen siparişlerde de kodlar şifreli alanla gelir.
• Gizli anahtarını kaybedersen yeni çift üret. Yeni açık anahtarı kaydettiğin andan sonra bütün yanıtlar, eski siparişlerin tekrar okunması dahil, yeni anahtarla şifrelenir.
• Şifreleme bir nedenle yapılamazsa düz kod kapalıyken yine gönderilmez, kalemde encryptionError alanı döner; bu durumda destek kaydı aç.
• Zarfın yapısı ile PHP, Node.js ve Python çözme örnekleri Bayi API dokümanının Kod şifreleme bölümünde.

İlgili sorular: Oyuneks Bayi API ile kendi sitemden otomatik sipariş nasıl veririm?, Oyuneks Bayi API test anahtarı nasıl alınır, test siparişi para harcar mı?