Skip to navigation

My Agents

My Agents

Endpoint Bilgileri

AlanDeğer
MethodGET
URLhttps://gatewayapi.insurapps.net/api/Offline/Agents
YetkilendirmeBearer Token

Kimliği doğrulanmış kullanıcının erişebildiği acentelerin (sigorta şirketleri ve brokerlar) listesini döner.

Bu endpoint yalnızca acente veya şirket rolüne sahip kullanıcılarla kısıtlıdır. Dönen liste, kullanıcının kimlik doğrulama token’ında yer alan atamalardan türetilir.


Kimlik Doğrulama

Geçerli bir bearer token gerektirir. Token şunları içermelidir:

  • Tanınan bir rol (agent veya company)

  • Geçerli bir sigorta şirketi ataması

  • Geçerli bir acente ataması (acente rolündeki kullanıcılar için)


Yanıt

200 OK — Başarılı Yanıt

Her biri Value (acente ID) ve Text (görünen ad) içeren bir acente nesneleri dizisi döner.

[
{ "Value": "1", "Text": "Albaraka Türk GM" },
{ "Value": "10751", "Text": "Albaraka Türk V2 PREP" }
]
AlanTipAçıklama
ValuestringAcentenin benzersiz tanımlayıcısı
TextstringAcentenin görünen adı

Hata Senaryoları

403 Forbidden — Acente veya Şirket Rolü Gerekli

Kimliği doğrulanmış kullanıcı agent veya company rolüne sahip değilse döner.

{
"Status": false,
"Code": "OfflineAgents.AgentOrCompanyRoleRequired",
"Message": "Only agent or company users are authorized for this endpoint.",
"Response": null
}

403 Forbidden — Geçerli Sigorta Şirketi Ataması Bulunamadı

Token’da geçerli bir sigorta şirketi ataması bulunmadığında döner.

{
"Status": false,
"Code": "OfflineAgents.InsuranceCompanyNotFound",
"Message": "No valid insurance company assignment found in token.",
"Response": null
}

403 Forbidden — Geçerli Acente Ataması Bulunamadı

Acente rolündeki kullanıcı için token’da geçerli bir acente ataması bulunmadığında döner.

{
"Status": false,
"Code": "OfflineAgents.AgentNotFound",
"Message": "No valid agent assignment found for agent user.",
"Response": null
}

Authentication

AuthorizationBearer

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

Response headers

Content-TypestringOptional
DatestringOptional
Content-EncodingstringOptional
Transfer-EncodingstringOptional
VarystringOptional
X-Frame-OptionsstringOptional
X-XSS-ProtectionstringOptional
X-Content-Type-OptionsstringOptional
Referrer-PolicystringOptional

Response

OK