API'ye Giriş ve Kimlik Doğrulama

RGS Developer API, mağazanızı kod ile yönetmenizi sağlar — bir muhasebe/ERP sisteminizle entegre etmek, toplu veri aktarmak veya kendi otomasyonlarınızı kurmak için kullanılır. Bu bölüm teknik ekibiniz veya entegrasyon ortağınız için yazılmıştır.

Temel bilgiler

• Taban adres: https://app.rgsyazilim.net/api/admin/{versiyon}
• Kimlik doğrulama: Authorization: Bearer <anahtarınız> başlığı
• Format: JSON; para alanları her zaman kuruş cinsinden tam sayı/metin olarak gönderilir ve döner ("12500" = 125,00 ₺)

API anahtarı oluşturma

Ayarlar → API Anahtarları bölümünden yeni bir anahtar oluşturursunuz. Anahtar oluştururken kapsam (scope) seçersiniz — anahtarın hangi verilere erişip hangi işlemleri yapabileceğini siz belirlersiniz. Örneğin sadece ürün okuma/yazma yetkisi olan, ödeme ayarlarına hiç erişemeyen bir anahtar oluşturabilirsiniz.

:::info Ödeme sağlayıcı kimlik bilgileri API kapsamı dışındadır Güvenlik gereği, ödeme sağlayıcı (PayTR, iyzico, banka sanal POS vb.) kimlik bilgileri API üzerinden hiçbir şekilde okunamaz veya yazılamaz. Bu ayarlar yalnızca panelden, Ayarlar → Ödeme Ayarları sayfasından elle girilir/değiştirilir. :::

Anahtarınızı koruyun

API anahtarınız, o kapsamdaki tüm yetkilerle mağazanıza erişim sağlar. Sadece güvendiğiniz entegrasyonlarla paylaşın, ihtiyaç kalmadığında anahtarı silin/yenileyin.

Devamı: Uç Nokta Referansı.