Access token nedir?
İTS'nin REST servisleri kullanıcı adı ve şifreyi her istekte istemez. Yazılım önce token servisine kullanıcı adı ve şifreyle başvurur ve karşılığında bir token alır. Sonraki bildirimlerde bu access token, isteğin başlığında Bearer olarak taşınır. Token kılavuzunda token alma, access token alma ve refresh token ile yenileme servisleri ayrı ayrı tanımlıdır.
Süreler
- Access token: 3600 saniye, yani 1 saat geçerlidir.
- Refresh token: 86400 saniye, yani 24 saat geçerlidir ve yeni access token almak için kullanılır.
- Yeni token alındığında eski token, kendi süresi dolana kadar geçerli kalır.
Süresi dolmuş bir tokenla gönderilen bildirim reddedilir. Uzun süren toplu gönderimlerde bu süreyi hesaba katmak gerekir.
Kullanıcı adı ve GLN
İTS kullanıcı adının ilk 13 hanesi paydaşın GLN'sidir. Kılavuzdaki örnek kullanıcı adı 17 hanedir: 86800010000110000. Kullanıcı adı ile GLN uyuşmadığında 11039 hatası alınır.
Güvenlik
Token ve onu üreten kullanıcı adı ile şifre, firmanız adına İTS'ye işlem gönderme yetkisi taşır. Bu yüzden:
- Kullanıcı adı ve şifreyi e-postayla ya da mesajlaşma uygulamalarıyla açık metin olarak paylaşmayın.
- Erişimi olan biri ayrıldığında şifreyi değiştirin.
- Test ortamının ve canlı sistemin bilgilerini birbirinden ayrı tutun.
Bulut bir program kullanıyorsanız bu bilgilerin nasıl saklandığını ve kimlerin erişebildiğini satın almadan önce sorun. Ayrıntılar için güvenlik sayfamıza bakabilirsiniz.