Geliştiriciler için
API ve Entegrasyon
Çağrı merkezi, santral veya web formu gibi dış sisteminizden izinleri Rıza AL'a iletin; izin değişikliklerini webhook ile alın.
Bölümler
Entegrasyonun tüm adımları
Tüm istekler https://apis.panel.riza.al adresine, imzalı olarak gönderilir.
- Bölüm 1Genel bakış ve akışDış sisteminizin aldığı izinleri Rıza AL'a nasıl ileteceğini ve değişikliklerden nasıl haberdar olacağını anlatan genel akış.
- Bölüm 2BaşlangıçÖn koşullar, panelden bağlantı oluşturma, bağlantı bilgileri, yönetim işlemleri, test modu ve webhook adresi kuralları.
- Bölüm 3Kimlik doğrulama ve istek imzasıAPI anahtarı, zaman damgası ve HMAC-SHA256 imzasıyla isteklerin nasıl doğrulandığı; Node.js ve bash örnekleri.
- Bölüm 4İzin uçlarıİzin girişi, toplu giriş, sorgu ve güncel durum uçlarının kullanımı; yöntem değerleri, zaman alanları ve iş kuralları.
- Bölüm 5Webhook olaylarıRıza AL'ın izin değişikliklerini size nasıl bildirdiği: olaylar, payload, başlıklar, imza doğrulama, tekilleştirme ve yeniden deneme.
- Bölüm 6Hata kodları, idempotency ve istek sınırlarıKarar sonuçları, REJECTED kodları, HTTP durum kodları, tekrar gönderim güvenliği ve dakikalık istek sınırı.
- Bölüm 7Uç referansıDış sistem uçlarının alan alan istek ve yanıt tabloları, örnekleri, durum kodları ve idempotency bilgisi.
- Bölüm 8Sorun gidermeSık karşılaşılan istek ve webhook sorunları için belirti, olası neden ve çözüm tabloları.
Panel
API erişiminizi panelden yönetin
Bağlantınızı oluşturmak, API anahtarınızı ve webhook adresinizi yönetmek için panelde Hesabım → Şirket Ayarları → API Erişimi sekmesini açın. Giriş yapmanız gerekir.
Entegrasyon için desteğe mi ihtiyacınız var?
Ekibimize yazın; API erişimi ve bağlantı kurulumunda size yardımcı olalım.
