Sandbox ve canlıya geçiş
Entegrasyon uygulaması kapalı beta kapsamındadır. Onaylanan uygulama önce
test ortamında (SANDBOX) çalışır; canlı kurum bağlantısı için ayrıca
canlıya geçiş incelemesi gerekir.
Test kurumu
Her geliştirici firmaya tek bir test kurumu atanır; firmanın tüm uygulamaları aynı test kurumunu kullanır.
| İşlem | API yolu | Yetki |
|---|---|---|
| Test kurumu ve örnek veriyi okuma | GET /api/v1/integration-apps/{id}/sandbox | Firma ADMIN, settings:read |
| Test olayı gönderme | POST /api/v1/integration-apps/{id}/sandbox/test-event | Firma ADMIN, settings:write |
Okuma yanıtı test kurumunun örnek verisini ve doğrulanmış, herkese açık en
fazla 20 GİB / Çalışma ve SGK mevzuatının kimlik, başlık ve kaynak bilgisini
döndürür. Test olayı BOARD_REPORT_READY türünde, livemode: false olarak
uygulamanın bu olaya abone etkin uçlarına gönderilir; yanıttaki queued
alanı kuyruğa alınan uç sayısıdır.
livemode ayrımı
- Test sırrı (
mr_app_test_) yalnız test kurumuyla, canlı sır (mr_app_live_) yalnız canlı kurumla çalışır. Sır, kurum ve izin ortamı uyuşmazsa istek403 INTEGRATION_ENVIRONMENT_MISMATCHalır. - Test olayları
livemode: falsetaşır ve olay akışında görünmez; akış yalnızlivemode: truekayıt döndürür. - Test ortamındaki uygulamalara gerçek GLOBAL mevzuat olayı gönderilmez.
- Test kurumu izinlerinin iptali
integration.grant_revokedolayı üretmez. - Test ortamında yalnız kayıtlı localhost port jokeri ek olarak desteklenir; ayrıntılar Kurum bağlantısı sayfasındadır.
Canlıya geçiş listesi
Firma yöneticisi POST /api/v1/integration-apps/{id}/request-live ile başvurur.
Başvuru yalnız SANDBOX durumundaki uygulama için kabul edilir; sözleşme ve
veri işleme eki kabulü ile iptal edilmiş bağlantı beyanı zorunludur. Platform
incelemesi aşağıdaki yedi maddenin tamamını ister:
| # | Madde |
|---|---|
| 1 | Yönlendirme, webhook ve gizlilik adresleri HTTPS ve yerel adres değil |
| 2 | Webhook alıcısı geçerli imzaya 2xx, bozuk imzaya ve 6 dakika eski imzaya 4xx döner |
| 3 | Test ortamında en az bir başarılı kod takası yapılmış |
| 4 | Geliştirici sözleşmesi ve veri işleme eki kabul edilmiş |
| 5 | Gizlilik politikası adresi HTTP 200 döner |
| 6 | İptal edilmiş bağlantı için 403 yanıtının işlendiği beyan edilmiş |
| 7 | Zorunlu alanlar tamam: işleme ülkesi TR, gizlilik adresi, HTTPS yönlendirme adresi veya sunucudan sunucuya beyanı, ticari unvan, 10 haneli VKN |
Kişisel veri kapsamı isteyen uygulamada 7. madde ayrıca bu kapsamların hukuk doğrulamasını ister; hukuk doğrulaması kaydı yoksa madde geçmez.
Sertifikasız bağlantı tavanı
Canlıya geçmemiş uygulama en fazla 25 farklı canlı kuruma bağlanabilir; test
kurumu bu sayıya girmez. Tavan dolunca yeni kurum onayı
409 Sertifikasız uygulama bağlantı tavanına ulaşıldı alır; aynı kurumun
mevcut bağlantısı etkilenmez. Tavanı yalnız platform yükseltebilir; canlıya
geçen uygulamaya bu tavan uygulanmaz.
Bu sayfa kapalı beta sözleşmesini anlatır; canlı ortamda genel kullanıma açıldığını göstermez.