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.
- Akış çalışınca panelden canlı anahtar üret ve yalnız anahtarı değiştir; kodun aynı kalır.
- Sonucu sürekli sorgulamak yerine PUT /bayi-api/v1/webhooks ile adresini kaydet; sipariş sonucu, fiyat değişimi ve bakiye yüklemesi sana imzalı olay olarak gelir.
Ö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 GET /bayi-api/v1/orders/{orderId} ucunda döner; webhook gövdesinde gönderilmez.
- expectedPrice gönderdiğinde fiyat değişmişse sipariş verilmez ve PRICE_CHANGED hatası güncel fiyatla döner.
- Hesabında API erişimi kapalıysa istekler API_ERISIMI_KAPALI hatası alır; bu durumda bayi temsilcinle 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.
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 webhook ile gönderilmez; sipariş yanıtında ve sorgusunda döner.
Son güncelleme: · Oyuneks Destek Ekibi
