Ürünlerim | InsurGateway

Token sahibinin yetkili olduğu ürünleri ürün kimliğine göre artan sıralı düz dizi olarak döner. Yetki kapsamı token’dan çözülür, bu nedenle aynı çağrı farklı kullanıcılar için farklı liste döndürür. Uç sayfalanmaz; yetkili olunan tüm ürünler tek yanıtta gelir.

Bir ürün token’daki birden fazla acenteye tanımlı olsa bile yanıtta tek kez yer alır.

Dönen Id değerleri, ürün kimliği bekleyen diğer uçlarda (productId) doğrudan kullanılır. InsuranceCompanyId ise GET /api/InsuranceCompanies/MyInsuranceCompanies yanıtındaki Id ile eşleşir.

Acente Seçimi

agentId verilmezse token’daki tüm acentelerin ürünleri birleştirilerek döner. Tek bir acenteye daraltmak için agentId gönderilir.

Token’daki rol	`agentId` verilmediğinde	`agentId` verildiğinde
`PlatformUser` / `PlatformSystemUser`	Token’daki tüm acentelerin ürünleri. Token’da acente yoksa 400.	Yalnızca o acentenin ürünleri. Acente token’da yoksa 400.
Diğer roller (ör. `Supervizor`)	Token’da acente yoksa 400.	Herhangi bir acente sorgulanabilir.

Token’ında acente taşıyan entegrasyon kullanıcıları yalnızca kendi acentelerini sorgulayabilir; başka bir acentenin ürünlerine bu uçtan erişilemez.

Uç Read yetkisi ister.

Kullanım

Ürün kümesi yalnızca acente–ürün yetkileri değiştiğinde değişir; her istek öncesi çağrılması gerekmez. Periyodik olarak çekip kendi tarafınızda saklayın.
Yanıt kullanıcıya özeldir. Önbelleklenecekse kullanıcı (ve varsa agentId) bazında önbelleklenmeli, ortak/global önbellekte tutulmamalıdır.
Status=false dönen ürünler yetki listesinde kalır ancak işlem kabul etmez; kendi tarafınızda seçilebilir göstermeyin.
Has3D=false iken Is3DRequired ve ThreeDPaymentType alanları anlamsızdır; ödeme akışını Has3D üzerinden kurgulayın.
Yanıtta ürünün yalnızca kimlik, sınıflandırma ve 3D ödeme bilgileri döner; teminat, parametre ya da prim bilgileri için ilgili uçlar kullanılmalıdır.

Token sahibinin yetkili olduğu ürünleri **ürün kimliğine göre artan** sıralı düz dizi olarak döner. Yetki kapsamı token'dan çözülür, bu nedenle aynı çağrı farklı kullanıcılar için farklı liste döndürür. Uç sayfalanmaz; yetkili olunan tüm ürünler tek yanıtta gelir. Bir ürün token'daki birden fazla acenteye tanımlı olsa bile yanıtta **tek kez** yer alır. Dönen `Id` değerleri, ürün kimliği bekleyen diğer uçlarda (`productId`) doğrudan kullanılır. `InsuranceCompanyId` ise `GET /api/InsuranceCompanies/MyInsuranceCompanies` yanıtındaki `Id` ile eşleşir. ## Acente Seçimi `agentId` verilmezse token'daki **tüm** acentelerin ürünleri birleştirilerek döner. Tek bir acenteye daraltmak için `agentId` gönderilir. | Token'daki rol | `agentId` verilmediğinde | `agentId` verildiğinde | | --- | --- | --- | | `PlatformUser` / `PlatformSystemUser` | Token'daki tüm acentelerin ürünleri. Token'da acente yoksa **400**. | Yalnızca o acentenin ürünleri. Acente token'da yoksa **400**. | | Diğer roller (ör. `Supervizor`) | Token'da acente yoksa **400**. | Herhangi bir acente sorgulanabilir. | Token'ında acente taşıyan entegrasyon kullanıcıları yalnızca kendi acentelerini sorgulayabilir; başka bir acentenin ürünlerine bu uçtan erişilemez. Uç `Read` yetkisi ister. ## Kullanım - Ürün kümesi yalnızca acente–ürün yetkileri değiştiğinde değişir; her istek öncesi çağrılması gerekmez. Periyodik olarak çekip kendi tarafınızda saklayın. - Yanıt kullanıcıya özeldir. Önbelleklenecekse kullanıcı (ve varsa `agentId`) bazında önbelleklenmeli, ortak/global önbellekte tutulmamalıdır. - `Status=false` dönen ürünler yetki listesinde kalır ancak işlem kabul etmez; kendi tarafınızda seçilebilir göstermeyin. - `Has3D=false` iken `Is3DRequired` ve `ThreeDPaymentType` alanları anlamsızdır; ödeme akışını `Has3D` üzerinden kurgulayın. - Yanıtta ürünün yalnızca kimlik, sınıflandırma ve 3D ödeme bilgileri döner; teminat, parametre ya da prim bilgileri için ilgili uçlar kullanılmalıdır.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

agentIdintegerOptional

Ürünleri istenen acente kimliği. Verilmezse token’daki tüm acenteler kullanılır. 0 veya negatif değerlerde 400 döner.

Response

Başarılı. Yetkili olunan ürünler ürün kimliğine göre sıralı düz dizi olarak döner.

IdintegerOptional

Ürün kimliği. Ürün bekleyen diğer uçlarda productId olarak bu değer gönderilir.

NamestringOptional

Ürün adı.

BranchIdinteger or nullOptional

Ürünün bağlı olduğu ürün branşı kimliği. Branşı tanımlanmamış ürünlerde null döner.

BranchNamestring or nullOptional

Ürün branşı adı (ör. Kasko, Trafik). BranchId boşsa null döner.

Categorystring or nullOptional

Ürünün branşı altındaki serbest metin kategori etiketi (ör. Kasko branşı için Markalı). Etiket olarak yönetilir; sabit bir değer kümesi yoktur. Tanımlanmamış ürünlerde null döner.

InsuranceCompanyIdinteger or nullOptional

Ürünün ait olduğu sigorta şirketi kimliği. GET /api/InsuranceCompanies/MyInsuranceCompanies yanıtındaki Id ile eşleşir.

StatusbooleanOptional

Ürünün InsurGateway tarafında aktif olup olmadığı. false dönen ürünler listede kalır ancak işlem kabul etmez; kendi tarafınızda seçilebilir göstermeyin.

Has3DbooleanOptional

Ürünün 3D Secure kart ödemesini destekleyip desteklemediği.

Is3DRequiredbooleanOptional

3D Secure’un zorunlu olup olmadığı; yalnızca Has3D=true iken anlamlıdır. true ise ürün 3D’siz kredi kartı ödemesi kabul etmez.

ThreeDPaymentTypeenum or nullOptional

3D Secure ödemesinin hangi yöntemle yürütüldüğü. Yalnızca Has3D=true iken anlamlıdır; 3D ödemesi olmayan ürünlerde null döner. 1 = PaymentGateway (ödeme sigorta şirketinin ödeme geçidi üzerinden tamamlanır), 2 = OTPTypeApprovement (ödeme tek kullanımlık şifre onayı ile tamamlanır).

Errors

400

Bad Request Error

401

Unauthorized Error