Oyuneks Bayi API ile kendi sitemden otomatik sipariş nasıl veririm?
Kısa cevap
Oyuneks Bayi API'si REST tabanlıdır: https://oyuneks.com/bayi-api/v1 adresinde Bearer anahtarla kataloğu ve bayi fiyatlarını çeker, POST /orders ile Idempotency-Key başlığıyla sipariş verir, kodları sipariş yanıtında ve sipariş sorgusunda alırsın. Doküman, OpenAPI ve Postman dosyaları oyuneks.com/bayi-api/docs adresinde herkese açıktır.
Hızlı başlangıç
- Bayi panelinde Entegrasyon > API anahtarları bölümünden önce bir test anahtarı üret. API anahtarı için hesabında iki adımlı doğrulama açık olmalı.
- GET /bayi-api/v1/me ile anahtarın doğru hesaba bağlı olduğunu ve yetki kapsamlarını kontrol et.
- GET /bayi-api/v1/catalog/products ile ürün kimliklerini, fiyatları ve oyuncu ID gibi zorunlu alanları çek.
- POST /bayi-api/v1/orders ile sipariş ver. Bu uçta Idempotency-Key başlığı zorunludur; aynı anahtarla tekrar gönderilen istek ikinci sipariş oluşturmaz. Tek istekte en fazla 50 kalem gönderebilirsin.
- Siparişin son durumunu ve kodları GET /bayi-api/v1/orders/{orderId} ile ya da kendi referansınla GET /bayi-api/v1/orders/by-ref/{externalRef} ile sorgula. Ağ hatasından sonra siparişin düşüp düşmediğini en hızlı referans sorgusuyla anlarsın.
- Akış çalışınca panelden canlı anahtar üret ve yalnız anahtarı değiştir; kodun aynı kalır.
Önemli kurallar
- Her istekte Authorization: Bearer başlığı gönderilir. Para alanları metin ve nokta ondalıklıdır (411.50 gibi), para birimi TRY, tarihler Türkiye saatiyle ISO-8601 biçimindedir.
- İstek tavanı anahtar başına dakikada okuma için 300, yazma için 60'tır; okuma ve yazma ayrı sayılır.
- Kodlar yalnız sipariş yanıtında ve sipariş sorgularında döner.
- expectedPrice gönderdiğinde fiyat değişmişse sipariş verilmez ve PRICE_CHANGED hatası güncel fiyatla döner.
- İstersen kodları kendi RSA açık anahtarınla şifreli alırsın: panelde API anahtarları ekranındaki Kod şifreleme kartından açarsın, durumu ve çözme testini GET /bayi-api/v1/encryption ile görürsün. Ayrıntısı: Bayi API'de kod şifreleme nedir?
- Gün sonu mutabakatı için GET /bayi-api/v1/balance/transactions ile cari hareketleri çek; her sipariş satırı orderId ve varsa kendi referansını taşır.
- Hesabında API erişimi kapalıysa istekler API_ERISIMI_KAPALI hatası alır; bu durumda bayi yöneticinle görüş.
Uçların tamamı, hata kodları ve cURL, PHP ve Node.js örnekleri Bayi API dokümanında. Aynı anahtarla yapay zeka istemcilerini MCP üzerinden bayi hesabına bağlamak da mümkün; ayrıntısı dokümandaki MCP ile bağlanma bölümünde.
İlgili sorular: Oyuneks Bayi API test anahtarı nasıl alınır, test siparişi para harcar mı?, Oyuneks e-pin bayisi olmak için nasıl başvururum?
Bilmen gerekenler
- Adres: https://oyuneks.com/bayi-api/v1; kimlik doğrulama Bearer anahtarla yapılır.
- POST /orders ucunda Idempotency-Key zorunlu; en fazla 64 karakter, 24 saat hatırlanır.
- İstek tavanı anahtar başına dakikada okuma 300, yazma 60.
- API anahtarı için hesapta iki adımlı doğrulama açık olmalı.
- Kodlar istenirse bayinin açık anahtarıyla şifreli verilir (GET /encryption).
Son güncelleme: · Oyuneks Destek Ekibi
